Convertire DOCX in Markdown
Per spostare la documentazione da Word a un repository Git, il primo passo è trasformare ogni .docx in Markdown. Questo convertitore produce testo in stile CommonMark con titoli #, tabelle con barre verticali e link alle immagini, pronto per il commit.
Convertitore di documenti
oppure trascina qui File PDF, DOC, DOCX … ·
Max 95 MB per file· Fino a 20 file· Eliminati dopo 30 minuti
I file vengono elaborati sui nostri server ed eliminati dopo 30 minuti.
150 DPI trasformano una pagina A4 in circa 1240 × 1754 px. Usare 300 per la stampa.
Converte l'intero file o solo alcune pagine o diapositive (per file PDF e presentazioni).
Pagine o diapositive da convertire, ad es. 1-3, 5, 8-10.
UTF-8 funziona per tutte le lingue. Scegliere UTF-8 con BOM se Excel o Blocco note su Windows mostrano caratteri illeggibili; le codifiche obsolete servono solo per software datato.
LF per macOS, Linux ed editor di codice; CRLF per programmi Windows meno recenti come il classico Blocco note.
La virgola è lo standard. Usare il punto e virgola per Excel nei paesi che scrivono i decimali con la virgola (Germania, Francia, Brasile, Italia).
File Excel con più fogli: converte tutti i fogli (una sezione o un file per foglio) oppure solo il primo.
Come usare questo strumento
- 1
Caricare i file Word
Aggiungere fino a 20 file .docx o .doc, fino a 95 MB ciascuno. Prima, in Word, accettare o rifiutare le modifiche registrate, perché Markdown non può mostrarle.
- 2
Controllare le opzioni del testo
Formattazione è su Semplice, Codifica del testo su UTF-8 e Fine riga su LF, la combinazione prevista da Git e dai generatori di siti statici. Lasciare attiva Includi le immagini per ottenere le immagini in una cartella.
- 3
Convertire ed estrarre
Premere Converti in MD. Ogni documento arriva in un file ZIP con il file .md e le sue immagini: estrarlo nella cartella della documentazione ed eseguire il commit.
Come convertire un documento Word in Markdown?
Caricare il file .docx e premere Converti in MD. Si ottiene un file .md con titoli #, elenchi, link e tabelle, più le immagini in una cartella accanto, tutto in un unico file ZIP.
Da DOCX a Markdown per il docs-as-code
I team adottano il docs-as-code per un motivo: la documentazione vive accanto al codice, passa dalle stesse pull request ed esce con la stessa release. Un .docx rompe questo schema, perché è uno ZIP di parti XML che Git memorizza come binario opaco. La modifica di una sola parola appare come file cambiato senza una differenza leggibile, e due persone che lavorano insieme non riescono a unire le modifiche.
Markdown è testo semplice, quindi ogni modifica è una riga che cambia in modo visibile. Dal 2014 è diventato anche molto più prevedibile, quando John MacFarlane e altri hanno pubblicato CommonMark, una specifica precisa della sintassi che Gruber aveva descritto in modo approssimativo dieci anni prima. Nel 2017 GitHub ha basato su CommonMark la propria specifica GitHub Flavored Markdown, aggiungendo tabelle con barre verticali, elenchi di attività e testo barrato, usati oggi nella maggior parte dei README.
Se il contenuto va in direzione opposta, cioè da Markdown a un revisore che lavora in Word, usare Markdown in DOCX. Per una pagina web e non per un repository, DOCX in HTML conserva più elementi di stile.
Come appare l'output in Markdown
## Checklist di rilascio Prima di creare il tag di una release, verificare quanto segue: - I test passano su **main** - Il changelog elenca ogni PR unita | Passaggio | Responsabile | | --- | --- | | Build | CI | | Pubblicazione | Maintainer | 
Dove verrà visualizzato il Markdown convertito
| Ente | Requisito | Fonte |
|---|---|---|
| GitHub | Visualizza README.md e qualsiasi file .md di un repository usando GitHub Flavored Markdown | github.com |
| Hugo | Genera pagine dai file di contenuto .md con un parser conforme a CommonMark | gohugo.io |
| Jekyll | Trasforma in pagine i file .md con front matter; è il motore di GitHub Pages | jekyllrb.com |
| Docusaurus | Legge i file .md e .mdx nella cartella docs come pagine di documentazione | docusaurus.io |
DOCX
Documento Microsoft Word
DOCX è il formato di documento predefinito di Microsoft Word da Office 2007, basato sullo standard Office Open XML (ECMA-376, ISO/IEC 29500). È un pacchetto ZIP di file XML che contiene testo, stili, immagini, tabelle, commenti e revisioni. È il formato più comune per i documenti modificabili in uffici, scuole e candidature di lavoro. L'impaginazione può cambiare leggermente tra Word, Google Documenti, LibreOffice e Pages, soprattutto con formattazioni complesse. La maggior parte dei programmi di videoscrittura apre i file DOCX.
- Compressione
- –
- Trasparenza
- –
- Animazione
- –
- Introdotto
- 2007 · Microsoft
MD
Markdown
Markdown è una sintassi di markup leggera creata da John Gruber nel 2004. Usa simboli di testo semplice, come # per i titoli, * per l'enfasi e - per gli elenchi, che restano leggibili anche come testo grezzo e si convertono in modo pulito in HTML. È lo standard per i file README, la documentazione, i wiki, le app per appunti e molti generatori di siti statici. Esistono diversi dialetti, come CommonMark e GitHub Flavored Markdown, che differiscono in dettagli come le tabelle. Qualsiasi editor di testo può aprire i file .md.
- Compressione
- –
- Trasparenza
- –
- Animazione
- –
- Introdotto
- 2004 · John Gruber
Si converte DOCX in Markdown quando un documento passa a un flusso di lavoro con il codice: un README, un sito di documentazione o una knowledge base gestita in Git, dove il testo semplice può essere confrontato, revisionato nelle pull request e interpretato da molti strumenti.
Funzioni di Word senza equivalente in Markdown
Da tenere presente prima della conversione
- Font, colori e layout di pagina vengono eliminati: Markdown descrive la struttura e l'aspetto è deciso dal tema del sito
- Le modifiche registrate e i commenti non vengono trasferiti, quindi vanno risolti prima in Word
- Intestazioni, piè di pagina e numeri di pagina non trovano posto in un file .md
- Le caselle di testo e le immagini con testo disposto intorno diventano normali paragrafi e link alle immagini
- I titoli formattati a mano, grassetto 16 pt invece di Titolo 2, diventano testo in grassetto, quindi conviene applicare prima i veri stili di titolo
- La sottolineatura non ha una sintassi Markdown e viene rimossa o mantenuta come HTML
Domande sulla conversione da DOCX a Markdown
Quale variante di Markdown segue l'output da DOCX a MD?
Titoli, enfasi, elenchi, link e codice seguono CommonMark, mentre le tabelle usano la sintassi con barre verticali di GitHub Flavored Markdown. GitHub, GitLab, Hugo, Jekyll e Docusaurus elaborano tutti questa combinazione.
Che cosa succede alle celle unite delle tabelle?
Le tabelle Markdown con barre verticali non prevedono celle unite, quindi ogni area unita viene divisa di nuovo in celle singole, con il testo nella prima. Le tabelle complesse si possono ricostruire in HTML dentro il .md, oppure semplificare in Word prima della conversione.
Dove finiscono le immagini del documento Word?
Con Includi le immagini attiva, ogni immagine viene salvata come file separato nello ZIP e il Markdown la richiama con un percorso relativo come images/figure-1.png. Quando si sposta il file .md, la cartella va tenuta accanto ad esso.
Le note a piè di pagina di Word si conservano in Markdown?
CommonMark non prevede una sintassi per le note a piè di pagina, ma nel 2021 GitHub ha aggiunto le note [^1] e la maggior parte dei generatori di siti le supporta. Se il renderer non le supporta, il testo delle note compare come normali paragrafi alla fine.
Si può convertire Google Docs in Markdown in questo modo?
Sì. In Google Docs scegliere File > Scarica > Microsoft Word (.docx), quindi caricare qui quel file. Google Docs offre anche un'opzione di download in Markdown, che funziona bene per i documenti semplici.
