Microsoft Loop zu HTML Export — Technical Guide
Kurz gesagt: Du exportierst alle Microsoft Loop Seiten als HTML mit einem Bash Script, das über die Graph API läuft: Die Search API findet die Files, der Parameter ?format=html konvertiert sie. Voraussetzung ist, dass ein Global Admin die App einmalig als Guest Application auf Loops SharePoint Embedded Container Type registriert.
Dieser Guide ist für dich, wenn du einen Microsoft Loop Workspace mit vielen Seiten in ein anderes System migrieren willst. Loop bietet dafür keinen offiziellen Weg. Wir zeigen, wie wir über 1.000 Seiten exportiert haben, mit allen Schritten, Fehlern und Sackgassen.
Das Wichtigste in Kürze
- Loop hat keine Export API. Es gibt keinen „Export Workspace“-Button, keinen Bulk Download und keinen dokumentierten programmatischen Zugriff.
- Loop Pages liegen in SharePoint Embedded Containern. Sie sind über die Microsoft Graph API zugänglich, brauchen aber ein eigenes Permission Model.
- Ein Global Admin muss die App einmalig registrieren. Ohne die SPE Guest Registration findet die App Files, kann aber deren Content nicht downloaden.
-
Der Export ist ein Script. Es entdeckt die Files per Search API, lädt HTML über
?format=htmlund schreibt Metadata und ein Manifest.
Warum der Export nicht trivial ist
Microsoft Loop ist ein attraktives Tool für kollaboratives Note-Taking. Es ist in den meisten Microsoft 365 Plans ohne Aufpreis enthalten, integriert sich nativ in Teams und Outlook und erledigt seinen Job für Meeting Notes, Projekt-Docs und Knowledge Bases. Für kleine und mittelgroße Organisationen, die ohnehin für M365 zahlen, ist es schwer, die Kosten für ein dediziertes Tool wie Notion oder Confluence zu rechtfertigen, wenn Loop einfach da ist. Bis man raus will.
Als wir unseren Workspace migrieren wollten, waren es über 1.000 Loop Pages, angesammelt über zwei Jahre täglicher Nutzung. Schnell wurde klar, dass die offensichtlichen Wege Sackgassen sind:
- Manuelles Copy-Paste: Nicht machbar bei 1.000+ Seiten. Selbst bei 2 Minuten pro Seite sind das über 33 Stunden stumpfe Arbeit.
- PDF Export: Loop bietet einen „Export to PDF“ pro Seite an. Der Output verliert sämtliche Struktur, Links und Formatierung, die ihn in einem Zielsystem brauchbar machen würden. Für eine Migration ist PDF ein Format zum Sterben, nicht zum Starten.
- Power Automate: Diverse Community Posts schlagen Power Automate Flows vor, um auf Loop Content zuzugreifen. Die Flows bestätigten, dass Loop Files programmatisch über SharePoints Storage Layer erreichbar sind. Power Automates Per-File Trigger Model und Throttling Limits machen es aber für Bulk Exports unpraktikabel.
Was Power Automate uns gegeben hat, war der entscheidende Hint: Loop Pages werden in SharePoint Embedded Containern gespeichert und sind über die Microsoft Graph API zugänglich. Dieser Hint hat uns in einen Rabbit Hole aus Entra ID App Registrations, undokumentierten Permission Models und PowerShell Cmdlets geschickt, die nur auf Windows funktionieren. Dieser Guide ist das, was wir auf der anderen Seite gefunden haben.
Fazit: Kopieren, PDF und Power Automate scheiden aus, der Weg führt über SharePoint Embedded und die Graph API.
Danksagung und Export Script
Wir haben das nicht from Scratch herausgefunden. Entscheidende Hinweise kamen aus der Community:
-
Marco De Tonis Frage auf Microsoft Q&A hat bestätigt, dass der
?format=htmlParameter der Graph API für Loop Files in SharePoint Embedded funktioniert. Das war das entscheidende Puzzlestück, das einen sauberen Export überhaupt erst möglich macht. - Diverse Blog Posts zu SharePoint Embedded Container Types und dem
FileStorageContainer.SelectedPermission Model haben uns durch den ansonsten undokumentierten SPE Guest Registration Prozess navigiert.
Falls du über Loops interne Storage Architecture oder SPE Permissions geschrieben hast: Danke. Deine Breadcrumbs haben uns Tage an Rätselraten erspart.
Das komplette Export Script (inklusive Shared Library) ist als GitHub Gist verfügbar: export-loop.sh
Fazit: Der Export beruht auf Hinweisen aus der Community und einem Script, das du als Gist bekommst.
Architektur: Wo Loop seine Seiten speichert

Microsoft Loop speichert Workspace Pages in SharePoint Embedded (SPE) Containern. Das sind keine regulären SharePoint Sites. Sie nutzen ein separates Permission Model, das eine explizite App Registration auf dem Loop Container Type erfordert.
Discovery: Search API (/search/query) <- Client Credentials Token
(Files.Read.All Application Permission)
Download: Drive API (/drives/{id}/...) <- Client Credentials Token
(FileStorageContainer.Selected + SPE Guest Registration)
Export: ?format=html Query Parameter <- Graph API konvertiert .loop -> HTML on the fly
- Die Search API kann Loop Files über SPE Container hinweg mit nur
Files.Read.Alldiscovern. - Aber direkter Drive/Item Access (Metadata, Content Download) erfordert, dass die App als Guest Application auf Loops Container Type via
Set-SPOApplicationPermissionregistriert ist. -
Files.Read.Allallein reicht nicht für SPE Container Content. Das ist eine dokumentierte Microsoft Limitation.
Das brauchst du für den Export:
| Komponente | Zweck |
|---|---|
| Azure AD App Registration | Client Credentials Auth für Graph API |
| Global Admin Access (einmalig) | App auf Loop Container Type registrieren |
| Windows PC mit PowerShell (einmalig) | SharePoint Online Management Shell |
macOS/Linux mit curl, jq, bash
|
Export Script ausführen |
Fazit: Discovery geht mit Files.Read.All, der Download braucht zusätzlich die Guest Registration auf Loops Container Type.
Step 1: App Registration in Entra ID
Lege eine neue App Registration an (oder verwende eine bestehende):
- Name: z.B. „Loop Export“
- Supported account types: Single Tenant („My organization only“)
- Platform: „Mobile and desktop applications“ Redirect URI hinzufügen (erforderlich für Public Client Flows)
API Permissions (Microsoft Graph, Application)
| Permission | Type | Description | Admin Consent |
|---|---|---|---|
Files.Read.All |
Application | Read files in all site collections | Yes |
Sites.Read.All |
Application | Read items in all site collections | Yes |
FileStorageContainer.Selected |
Application | Access selected file storage containers | Yes |
Erteile Admin Consent für alle drei Permissions.
Client Secret
Erstelle unter „Certificates & secrets“ ein Client Secret. Notiere den Value, er kann danach nicht mehr abgerufen werden.
Allow Public Client Flows
Setze unter „Authentication“ > „Advanced settings“ „Allow public client flows“ auf Yes. Das wird benötigt, falls du Device Code Flow für Delegated Access nutzen möchtest. Für den reinen Client Credentials Export ist es optional, aber empfohlen.
Werte notieren
Application (client) ID: <your-client-id>
Directory (tenant) ID: <your-tenant-id>
Client Secret Value: <your-secret>
Speichere sie in einer .env Datei:
LOOP_CLIENT_ID=<your-client-id>
LOOP_CLIENT_SECRET=<your-secret>
LOOP_TENANT_ID=<your-tenant-id>
Fazit: Drei Application Permissions mit Admin Consent und ein Client Secret reichen für die App, die Guest Registration folgt in Step 2.
Step 2: SPE Guest App Registration (erfordert Global Admin)
Das ist der kritische Step. Ohne ihn kann die App Loop Files via Search discovern, aber deren Content nicht downloaden.
Warum das nötig ist
Loop nutzt SharePoint Embedded (SPE) Container mit der Container Type ID a187e399-0c36-4b98-8f04-1edc167a0996. Das ist ein Microsoft-eigener Container Type. Third-Party Apps müssen explizit als „Guest Applications“ registriert werden, um auf Content in diesen Containern zugreifen zu können.
Vorgehen
Führe das auf einem Windows PC aus, denn die SharePoint Online Management Shell funktioniert auf macOS nicht zuverlässig:
# 1. Modul installieren (einmalig)
Install-Module Microsoft.Online.SharePoint.PowerShell
# 2. Als Global Admin connecten
Connect-SPOService -Url "https://<tenant>-admin.sharepoint.com"
# 3. App als Guest auf Loops Container Type registrieren
Set-SPOApplicationPermission -OwningApplicationId "a187e399-0c36-4b98-8f04-1edc167a0996" -GuestApplicationId "<your-client-id>" -PermissionAppOnly "readcontent"
Wichtige Hinweise
-
-OwningApplicationId: Immera187e399-0c36-4b98-8f04-1edc167a0996(Loops Container Type, identisch für alle Tenants). -
-GuestApplicationId: Die Client ID der App aus Step 1. -
-PermissionAppOnly: Lowercase"readcontent"verwenden (nicht"ReadContent"). -
Delegated Permissions: Werden von SPE aktuell nicht unterstützt. Lass den
-PermissionDelegatedParameter weg. - Benötigte Rolle: Global Admin. SharePoint Admin allein reicht für dieses Cmdlet nicht.
- Einmalige Operation: Muss nur einmal pro App Registration durchgeführt werden.
Häufige Fehler
| Error | Ursache | Fix |
|---|---|---|
(403) Forbidden bei Connect-SPOService
|
User ist kein SharePoint Admin oder Global Admin | Korrekte Rolle in Entra ID zuweisen |
Attempted to perform an unauthorized operation |
User ist SharePoint Admin, aber nicht Global Admin | Global Admin Account verwenden |
Invalid AppOnlyPermissions: ["ReadContent"] |
Falsche Schreibweise | Lowercase verwenden: "readcontent"
|
Delegated permissions not supported |
SPE Limitation |
-PermissionDelegated Parameter weglassen |
| Backtick Line Continuation funktioniert nicht | PowerShell Parsing Issue | Als einzelne Zeile einfügen |
Fazit: Die Guest Registration macht ein Global Admin einmalig auf Windows, mit Lowercase „readcontent“ und ohne Delegated Permissions.
Step 3: Export ausführen
So funktioniert das Export Script
1. Authenticate via Client Credentials (OAuth2 client_credentials Grant)
2. Alle .loop/.fluid Files via POST /search/query discovern
- Nutzt den Region Parameter (z.B. "EUR") — erforderlich für Application Permissions
- Paginiert durch alle Results (25 pro Page)
3. Für jedes File:
a. HTML via GET /drives/{driveId}/items/{itemId}/content?format=html downloaden
b. Metadata (Author, Dates, Permissions) als JSON speichern
c. Fallback auf Raw .loop Download falls HTML Conversion fehlschlägt
4. manifest.json mit komplettem Inventory schreiben
Drive ID Encoding
Loop Drive IDs enthalten ! (z.B. b!a2IBG9x...). In Graph API URLs muss das ! als %21 URL-encoded werden. Das --path-as-is curl Flag verhindert, dass curl die URL normalisiert.
GET /drives/b%21a2IBG9x.../items/{itemId}/content
Usage
# Dry Run — Files discovern ohne Download
./tools/export-loop.sh --dry-run
# Full Export (idempotent — überspringt bereits exportierte Files)
./tools/export-loop.sh
# Force Re-Export aller Files
./tools/export-loop.sh --force
Output Struktur
exports/loop/
manifest.json # Komplettes Inventory mit Status pro File
pages/
Filename__itemId.html # HTML Export jeder Loop Page
meta/
Filename__itemId.json # Metadata (Author, Dates, Permissions)
Token Refresh
Das Script refresht den Client Credentials Token automatisch alle 45 Minuten. Bei Exports mit 700+ Files passiert das transparent während des Runs.
Fazit: Starte mit einem Dry Run, dann läuft der Export idempotent durch und schreibt HTML, Metadata und ein Manifest.
API Details
Search API (Discovery)
POST https://graph.microsoft.com/v1.0/search/query
Authorization: Bearer <client-credentials-token>
Content-Type: application/json
{
"requests": [{
"entityTypes": ["driveItem"],
"query": { "queryString": "filetype:loop OR filetype:fluid" },
"from": 0,
"size": 25,
"region": "EUR"
}]
}
-
region: Erforderlich für Application Permissions."EUR"für europäische Tenants,"NAM"für Nordamerika, etc. -
Pagination:
from+sizeverwenden undmoreResultsAvailablein der Response checken. - Returns: File Name, driveId, itemId, Size, Dates, Authors, webUrl, parentReference.
HTML Download
GET https://graph.microsoft.com/v1.0/drives/{driveId}/items/{itemId}/content?format=html
Authorization: Bearer <client-credentials-token>
- Der
?format=htmlParameter triggert serverseitige Conversion von.loopFormat zu HTML. - Folgt Redirects (mit
curl -L). - Gibt vollständiges HTML mit Inline Styles zurück.
Raw Download (Fallback)
GET https://graph.microsoft.com/v1.0/drives/{driveId}/items/{itemId}/content
Authorization: Bearer <client-credentials-token>
- Downloadet das Raw
.loopFile (Fluid Framework Format). - Nützlich, falls die HTML Conversion für bestimmte Files fehlschlägt.
Fazit: Search findet die Files mit Region Parameter, ?format=html liefert das HTML, der Raw Download ist der Fallback.
Troubleshooting
„403 Forbidden“ bei Drive/Item Access
Die App ist nicht als SPE Guest registriert. Führe Step 2 durch.
Search liefert Files, aber Download schlägt fehl
Selbe Ursache. Die Search API hat speziellen Cross-Container Access, der SPE Restrictions umgeht, direkter Drive Access aber nicht.
„Resource not found for segment '!...'“
Das ! in Drive IDs wird URL-decoded. Stelle sicher, dass es als %21 encoded ist.
„File name too long“ beim Export
Manche Loop Page Names überschreiten Filesystem Limits (255 Bytes auf macOS). Das Export Script kürzt Filenames auf 100 Zeichen.
Client Credentials Token funktioniert für Search, aber nicht für Downloads
Stelle sicher, dass alle drei Voraussetzungen erfüllt sind:
-
Files.Read.All(Application) für die Search API -
FileStorageContainer.Selected(Application) für SPE Container - SPE Guest Registration via
Set-SPOApplicationPermission, die die Permission mit Loops Container Type verknüpft
Device Code Flow schlägt fehl mit „client_assertion or client_secret required“
Azure AD unterstützt keinen Device Code Flow für Confidential Clients (Apps mit Secrets). Verwende stattdessen den Client Credentials Flow, der nach der SPE Guest Registration funktioniert.
Fazit: Fast jeder Fehler beim Download geht auf die fehlende Guest Registration oder ein nicht encodiertes Ausrufezeichen zurück.
Was nicht funktioniert
Diese Ansätze wurden getestet und als nicht funktionierend für Loop SPE Container bestätigt:
| Ansatz | Ergebnis |
|---|---|
Files.Read.All (Application) ohne SPE Registration |
Search geht, Drive Access 403 |
Files.Read.All (Delegated via Device Code) |
Azure AD lehnt Device Code für Confidential Clients ab |
az login Token für SharePoint Admin REST API |
Falscher Scope (user_impersonation nicht an Azure CLI granted) |
Connect-SPOService auf macOS |
„Object reference not set to an instance of an object“ |
Set-SPOApplication PowerShell Cmdlet |
Hat keinen -ApplicationId Parameter, falsches Cmdlet |
Graph API /admin/sharepoint/settings/containerTypes/
|
Endpoint existiert nicht (weder v1.0 noch beta) |
Container Listing via /storage/fileStorage/containers
|
403 ohne SPE Registration |
Fazit: Spare dir diese sieben Umwege, sie führen alle in eine Sackgasse.
Quellen und Grenzen
- SharePoint Embedded Docs (Stand der Veröffentlichung, 14.03.2026)
- Graph Search API (Stand der Veröffentlichung, 14.03.2026)
- Marco De Tonis Frage auf Microsoft Q&A (Stand der Veröffentlichung, 14.03.2026)
- Loop Container Type ID:
a187e399-0c36-4b98-8f04-1edc167a0996(konstant über alle Tenants) - SPO PowerShell Module:
Microsoft.Online.SharePoint.PowerShell(v16.0.27011+)
Der Guide beruht auf unserer eigenen Migration von über 1.000 Loop Pages. Microsoft dokumentiert für Loop keinen programmatischen Zugriff auf die eigenen Inhalte, deshalb kann sich das Verhalten der Graph API oder der SPE Permissions ändern. Delegated Permissions unterstützt SPE aktuell nicht.
Häufige Fragen
Gibt es eine Export API oder einen Bulk Download für Microsoft Loop?
Nein. Loop hat keine Export API, keinen „Export Workspace“-Button, keinen Bulk Download und keinen dokumentierten programmatischen Zugriff. Pro Seite gibt es nur „Export to PDF“, das Struktur, Links und Formatierung verliert.
Warum reicht Files.Read.All nicht für den Download?
Files.Read.All genügt, damit die Search API Loop Files über SPE Container hinweg findet. Direkter Drive/Item Access erfordert zusätzlich, dass die App als Guest Application auf Loops Container Type registriert ist. Das ist eine dokumentierte Microsoft Limitation.
Wer darf die SPE Guest Registration durchführen und wie oft?
Dafür brauchst du einen Global Admin, ein SharePoint Admin allein reicht nicht. Die Registration läuft einmalig pro App Registration auf einem Windows PC mit der SharePoint Online Management Shell.
Wie bekomme ich meine Loop Pages als HTML?
Das Export Script entdeckt alle .loop und .fluid Files über die Search API und lädt sie mit dem Parameter ?format=html herunter. Dazu speichert es Metadata als JSON und schreibt ein manifest.json. Der Full Export ist idempotent und überspringt bereits exportierte Files.
Was bedeutet „403 Forbidden“ beim Download, obwohl die Search funktioniert?
Die App ist dann nicht als SPE Guest registriert. Die Search API umgeht die SPE Restrictions, direkter Drive Access nicht. Führe Step 2 durch.