← Torna al blog

Come Salvare le Pagine Confluence come Markdown

· Save Team
confluencedocumentationwikienterprise

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]