Come Esportare Pagine Confluence in Markdown (Guida 2026)

Confluence non vuole che tu vada via. Atlassian archivia i tuoi contenuti in un formato XML proprietario, non offre esportazione Markdown e rende l’estrazione in blocco dolorosa. Se hai mai provato a ottenere testo pulito da Confluence, conosci la frustrazione.

Questa guida copre ogni metodo per esportare pagine Confluence in Markdown --- da singole pagine a interi spazi.

Perché Esportare da Confluence a Markdown?

I team si allontanano da Confluence per molte ragioni:

• Migrazione a un nuovo strumento --- passare a Notion, GitBook, Docusaurus o un generatore di siti statici che si aspetta Markdown
• Archiviazione di una base di conoscenza --- preservare la documentazione del team prima che scada una licenza Atlassian
• Costruzione di una base di conoscenza AI --- fornire documentazione pulita a Claude, ChatGPT o un LLM interno
• Backup di documenti critici --- avere una copia portatile che non dipende dai server di Atlassian
• Uscita dal vendor lock-in --- possedere i tuoi contenuti in un formato universale

Metodo 1: Save (Il Più Veloce per Singole Pagine)

Save è un’estensione Chrome che converte qualsiasi pagina Confluence in Markdown pulito con un click.

Come funziona:

1. Apri qualsiasi pagina Confluence in Chrome
2. Clicca sull’icona dell’estensione Save
3. Un file .md viene scaricato istantaneamente

Cosa ottieni:

• Testo completo della pagina con gerarchia dei titoli
• Tabelle formattate come tabelle Markdown
• Blocchi di codice con tag di linguaggio
• Pannelli informativi convertiti in citazioni a blocco
• Sezioni espandi/comprimi (completamente espanse)
• Metadati puliti: titolo pagina, nome spazio, data ultima modifica
• Link interni ed esterni preservati

Cosa viene rimosso:

• Macro Atlassian e formattazione proprietaria
• Chrome di navigazione, barre laterali e menu
• Artefatti dell’editor WYSIWYG
• Stili inline e CSS

Ideale per: Salvare singole pagine o piccoli gruppi. Se hai bisogno di 5-50 pagine, questo è il metodo più veloce.

Output di Esempio

Da un tipico runbook Confluence:

# Deployment Runbook --- Production API

**Space:** Engineering
**Last updated:** March 12, 2026

---

## Pre-Deployment Checklist

- [ ] All CI checks passing on `main`
- [ ] Database migrations reviewed and approved
- [ ] Feature flags configured for gradual rollout
- [ ] Rollback plan documented

## Deployment Steps

### 1. Create Release Branch

\`\`\`bash
git checkout -b release/v2.4.0 main
git push origin release/v2.4.0
\`\`\`

### 2. Run Database Migrations

\`\`\`sql
ALTER TABLE users ADD COLUMN preferences JSONB DEFAULT '{}';
CREATE INDEX idx_users_preferences ON users USING GIN (preferences);
\`\`\`

Metodo 2: Esportazione Integrata di Confluence (HTML, Poi Converti)

Confluence può esportare pagine come HTML. Puoi poi convertire l’HTML in Markdown usando uno strumento come Pandoc.

Passaggi:

1. Vai alla pagina → menu … → Esporta in PDF/Word/HTML
2. Scegli esportazione HTML
3. Converti con Pandoc: pandoc input.html -o output.md

Problemi con questo approccio:

• L’esportazione HTML include CSS di Atlassian, macro e stili inline
• Le tabelle spesso si rompono durante la conversione
• I blocchi di codice perdono i tag di linguaggio
• Le immagini fanno riferimento a URL Confluence che potrebbero rompersi in seguito
• Le pagine annidate richiedono l’esportazione dell’intero spazio

Questo metodo funziona ma produce un output disordinato che richiede pulizia manuale.

Metodo 3: Esportazione Spazio + Conversione in Blocco

Per esportare un intero spazio Confluence:

1. Vai a Impostazioni Spazio → Strumenti Contenuto → Esporta
2. Scegli il formato HTML
3. Scarica l’archivio ZIP
4. Usa uno script per convertire in blocco i file HTML in Markdown

Il problema: Le esportazioni degli spazi Confluence producono HTML profondamente annidato con link relativi rotti, elementi di navigazione duplicati e markup specifico di Atlassian. Pulire tutto questo programmaticamente è un progetto di un weekend.

Metodo 4: REST API di Confluence

Per l’accesso programmatico:

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

Questo ti dà il formato di archiviazione grezzo (simile a XHTML). Dovrai:

1. Analizzare il formato di archiviazione Atlassian
2. Gestire macro, embed ed elementi speciali
3. Convertire in Markdown
4. Ripetere per ogni pagina

Ideale per: Team di ingegneria che costruiscono una pipeline di migrazione. Eccessivo per la maggior parte dei casi d’uso.

Quale Metodo Dovresti Usare?

Scenario	Metodo Migliore
Salva 1-50 pagine rapidamente	Estensione Save --- un click per pagina
Archivia un intero spazio	Esportazione spazio + Pandoc --- in blocco ma disordinato
Costruisci una pipeline di migrazione	REST API --- programmatico ma complesso
Backup rapido di documenti chiave	Estensione Save --- output più pulito
Alimenta documenti a un LLM	Estensione Save --- Markdown è nativo per LLM

Per la maggior parte delle persone, Save è la risposta. Produce il Markdown più pulito senza alcuna configurazione e gestisce automaticamente la formattazione proprietaria di Confluence.

Rendere Utili i Tuoi Contenuti Confluence

Una volta esportate le tue pagine in Markdown, puoi:

• Cercare in tutto con grep, VS Code o Obsidian
• Fornirlo a Claude o ChatGPT per risposte immediate sulla tua documentazione
• Metterlo sotto version control in Git --- traccia le modifiche ai tuoi documenti come codice
• Importarlo in qualsiasi strumento --- Notion, Obsidian, GitBook, Docusaurus o un generatore di siti statici
• Conservarlo per sempre --- i file Markdown sono testo semplice. Saranno leggibili tra 50 anni

Inizia

Installa Save e provalo su una pagina Confluence adesso. È gratis per iniziare, e vedrai Markdown pulito in pochi secondi.

---

Uscire da Confluence non deve essere doloroso. Save converte qualsiasi pagina in Markdown pulito con un click.