Come Salvare le Pagine Confluence come Markdown

Confluence è il posto dove la conoscenza aziendale va a vivere — e da cui è quasi impossibile tirarla fuori. Il formato di archiviazione proprietario di Atlassian, l’export goffo e l’editor WYSIWYG rendono doloroso estrarre contenuti puliti. Ecco come salvare le pagine Confluence come Markdown.

Perché Salvare Confluence come Markdown?

Estrarre contenuti da Confluence è notoriamente difficile:

• Formato proprietario — Confluence archivia i contenuti nel suo formato basato su XML
• L’export HTML è gonfio — pieno di macro, stili e markup di Atlassian
• Nessun export Markdown nativo — non è un’opzione nel menu di esportazione
• L’export di massa è caotico — gli export degli spazi producono HTML annidato con link rotti
• Lock-in del vendor — migrare via da Confluence è un progetto a sé stante

Cosa Cattura Save da Confluence

Contenuto della Pagina

• Testo completo con gerarchia dei titoli
• Tabelle (correttamente formattate come tabelle Markdown)
• Blocchi di codice con tag del linguaggio
• Pannelli info e note (convertiti in citazioni)
• Sezioni espandi/comprimi (contenuto espanso)
• Elenchi puntati e numerati
• Link interni ed esterni

Esempio di Output

# Runbook di Deployment — API di Produzione

**Spazio:** Engineering
**Ultimo aggiornamento:** 12 marzo 2026

---

## Checklist Pre-Deployment

- [ ] Tutti i controlli CI superati su main
- [ ] Migrazioni database riviste e approvate
- [ ] Feature flag configurati per rilascio graduale
- [ ] Ingegnere di turno identificato e disponibile
- [ ] Piano di rollback documentato

## Passaggi di Deployment

### 1. Crea Branch di Release

\`\`\`bash
git checkout main && git pull
git checkout -b release/v2.4.1
git push -u origin release/v2.4.1
\`\`\`

### 2. Esegui le Migrazioni Database

| Ambiente | Comando | Timeout |
|----------|---------|---------|
| Staging | `npm run migrate:staging` | 5 min |
| Produzione | `npm run migrate:prod` | 15 min |

> **Attenzione:** Esegui sempre le migrazioni su staging prima.
> Le migrazioni di produzione richiedono l'approvazione di @devops.

Casi d’Uso

Migrazione da Confluence

• Salva le pagine una alla volta come Markdown pulito
• Costruisci incrementalmente la tua nuova knowledge base
• Migra a Obsidian, Notion, GitBook o un sistema docs-as-code
• Nessun bisogno di costosi strumenti di migrazione

Estrazione di Conoscenza Personale

• Salva le pagine più rilevanti per il tuo lavoro
• Costruisci una libreria di riferimento portabile
• Mantieni l’accesso alla documentazione dopo aver lasciato un’azienda
• Crea copie offline dei runbook critici

Pulizia della Documentazione

• Salva le pagine esistenti, puliscile in Markdown e reimportale
• Usa come punto di partenza per riscrivere la documentazione
• Confronta le versioni vecchie e nuove in uno strumento di diff
• Controlla la qualità della documentazione in uno spazio

Ricerca con AI

• Salva le pagine Confluence come Markdown per l’elaborazione AI
• Fornisci documenti interni agli strumenti AI per una ricerca migliore
• Costruisci un corpus Markdown per RAG (Retrieval-Augmented Generation)
• Ottieni risposte AI dalla knowledge base della tua azienda

Consigli per i Migliori Risultati

1. Salva dalla visualizzazione della pagina — non dall’editor, non dalla panoramica dello spazio
2. Espandi tutte le sezioni — clicca per espandere le macro espandi/comprimi prima di salvare
3. Allegati — Save cattura il contenuto testuale; scarica separatamente gli allegati se necessario
4. Macro — le macro di Confluence (link Jira, grafici) si convertono in testo normale o link
5. Permessi — Save può catturare solo le pagine che hai il permesso di visualizzare

Inizia

Installa Save dal Chrome Web Store — libera i tuoi contenuti Confluence.

---

Hai domande? Scrivici a [email protected]