Hur Man Exporterar Confluence-sidor till Markdown (Guide 2026)
Confluence vill inte att du lämnar. Atlassian lagrar ditt innehåll i ett eget XML-format, erbjuder ingen Markdown-export och gör bulkextrahering smärtsam. Om du någonsin försökt få ut ren text från Confluence vet du frustrationen.
Den här guiden täcker varje metod för att exportera Confluence-sidor till Markdown --- från enstaka sidor till hela spaces.
Varför Exportera Confluence till Markdown?
Team lämnar Confluence av många anledningar:
- Migrera till ett nytt verktyg --- flytta till Notion, GitBook, Docusaurus eller en statisk webbplatsgenerator som förväntar sig Markdown
- Arkivera en kunskapsbas --- bevara teamdokumentation innan en Atlassian-licens löper ut
- Bygga en AI-kunskapsbas --- mata ren dokumentation till Claude, ChatGPT eller en intern LLM
- Säkerhetskopiera kritiska dokument --- ha en portabel kopia som inte beror på Atlassians servrar
- Fly leverantörsberoende --- äga ditt innehåll i ett universellt format
Metod 1: Save (Snabbast för Enskilda Sidor)
Save är ett Chrome-tillägg som konverterar vilken Confluence-sida som helst till ren Markdown med ett klick.
Hur det fungerar:
- Öppna en Confluence-sida i Chrome
- Klicka på Save-tilläggets ikon
- En
.md-fil laddas ned omedelbart
Vad du får:
- Full sidtext med rubrikhierarki
- Tabeller formaterade som Markdown-tabeller
- Kodblock med språktaggar
- Informationspaneler konverterade till blockcitat
- Expandera/dölj-sektioner (fullt expanderade)
- Ren metadata: sidrubrik, space-namn, datum för senaste uppdatering
- Interna och externa länkar bevarade
Vad som tas bort:
- Atlassian-makron och egna formateringar
- Navigeringskrom, sidofält och menyer
- WYSIWYG-redigeringsartefakter
- Inline-stilar och CSS
Bäst för: Spara enstaka sidor eller små batchar. Om du behöver 5-50 sidor är detta den snabbaste metoden.
Exempelutdata
Från ett typiskt Confluence runbook:
# Driftsättningsrunbook --- Produktions-API
**Space:** Engineering
**Senast uppdaterad:** 12 mars 2026
---
## Checklista Före Driftsättning
- [ ] Alla CI-kontroller godkända på `main`
- [ ] Databasmigrationer granskade och godkända
- [ ] Feature flags konfigurerade för gradvis utrullning
- [ ] Återställningsplan dokumenterad
## Driftsättningssteg
### 1. Skapa Release-gren
\`\`\`bash
git checkout -b release/v2.4.0 main
git push origin release/v2.4.0
\`\`\`
### 2. Kör Databasmigrationer
\`\`\`sql
ALTER TABLE users ADD COLUMN preferences JSONB DEFAULT '{}';
CREATE INDEX idx_users_preferences ON users USING GIN (preferences);
\`\`\`
Metod 2: Confluences Inbyggda Export (HTML, Sedan Konvertera)
Confluence kan exportera sidor som HTML. Du kan sedan konvertera HTML till Markdown med ett verktyg som Pandoc.
Steg:
- Gå till sidan → …-meny → Exportera till PDF/Word/HTML
- Välj HTML-export
- Konvertera med Pandoc:
pandoc input.html -o output.md
Problem med denna metod:
- HTML-export inkluderar Atlassians CSS, makron och inline-stilar
- Tabeller bryts ofta under konverteringen
- Kodblock förlorar språktaggar
- Bilder refererar till Confluence-URL:er som kan brytas senare
- Kapslade sidor kräver export av hela spacen
Den här metoden fungerar men producerar rörig utdata som kräver manuell rensning.
Metod 3: Space-export + Bulkkonvertering
För export av ett helt Confluence-space:
- Gå till Space-inställningar → Innehållsverktyg → Exportera
- Välj HTML-format
- Ladda ner ZIP-arkivet
- Använd ett skript för att batch-konvertera HTML-filer till Markdown
Problemet: Confluence space-exporter producerar djupt kapslad HTML med trasiga relativa länkar, duplicerade navigationselement och Atlassian-specifik markup. Att städa upp detta programmatiskt är ett helgprojekt.
Metod 4: Confluence REST API
För programmatisk åtkomst:
curl -u [email protected]:API_TOKEN \
"https://your-domain.atlassian.net/wiki/rest/api/content/PAGE_ID?expand=body.storage" \
| jq -r '.body.storage.value' > page.html
Detta ger dig det råa lagringsformatet (XHTML-liknande). Du behöver:
- Parsa Atlassians lagringsformat
- Hantera makron, inbäddningar och specialelement
- Konvertera till Markdown
- Upprepa för varje sida
Bäst för: Ingenjörsteam som bygger en migreringspipeline. Överdrivet för de flesta användningsfall.
Vilken Metod Bör Du Använda?
| Scenario | Bästa Metod |
|---|---|
| Spara 1-50 sidor snabbt | Save-tillägg --- ett klick per sida |
| Arkivera ett helt space | Space-export + Pandoc --- bulk men rörigt |
| Bygga en migreringspipeline | REST API --- programmatiskt men komplext |
| Snabb säkerhetskopiering av nyckeldokument | Save-tillägg --- renast utdata |
| Mata dokument till en LLM | Save-tillägg --- Markdown är LLM-native |
För de flesta är Save svaret. Det producerar den renaste Markdown utan setup, och hanterar Confluences egna formatering automatiskt.
Göra Ditt Confluence-innehåll Användbart
När du har exporterat dina sidor till Markdown kan du:
- Söka i allt med grep, VS Code eller Obsidian
- Mata Claude eller ChatGPT för omedelbara svar om din dokumentation
- Versionskontrollera det i Git --- spåra ändringar i dina dokument som kod
- Importera till vilket verktyg som helst --- Notion, Obsidian, GitBook, Docusaurus eller en statisk webbplatsgenerator
- Behålla det för alltid --- Markdown-filer är ren text. De kommer vara läsbara om 50 år
Kom Igång
Installera Save och prova det på en Confluence-sida just nu. Det är gratis att börja, och du ser ren Markdown på sekunder.
Att fly Confluence behöver inte vara smärtsamt. Save konverterar vilken sida som helst till ren Markdown med ett klick.