La formattazione è dove la maggior parte delle conversioni Word-to-Markdown vanno male. Il testo in grassetto viene visualizzato come testo semplice. I tavoli crollano. I titoli diventano paragrafi senza stile. Questa guida spiega esattamente cosa accade durante Word in Markdown la conversione e il modo di controllare l'uscita.
Comprendere il processo di conversione
Quando si converte un documento Word in Markdown, accadono due cose:
- DOCX → HTML mammoth.js analizza il Word XML e mappia ogni elemento a HTML
- HTML → Markdown Turndown converte la sintassi HTML in Markdown
Il secondo passo è senza perdite se il HTML è pulito. Il primo passo è dove la complessità di formattazione è importante Words stili devono mappare agli equivalenti HTML noti.
Utilizzo Convertitore WordToMDs per vedere esattamente come il documento si converte in tempo reale.
Stili di intestazione
La decisione di formattazione più importante in Word è l'uso di stili di intestazione incorporati.
| Word Stile | Markdown Uscita |
|---|---|
| Rubrica 1 | # Heading |
| Rubrica 2 | ## Heading |
| Rubrica 3 | ### Heading |
| Normale (testo in grassetto) | **text** (NESSUNO titolo) |
Errore comune: Formattare manualmente il testo come grande e grassetto invece di applicare uno stile Heading. Questo sembra un titolo in Word ma converte in testo in grassetto in Markdown, non ##.
Per il riferimento completo alle voci, vedere Markdown Guida delle rubriche.
L'accento sul testo
| Word Formattazione | Markdown Uscita |
|---|---|
| Audace | **Bold** |
| Corrispondenza | *Italic* |
| Italica grassetta | ***Bold Italic*** |
~~Strikethrough~~ | |
| Sottolineare | (non Markdown equivalente omesso) |
| Sottolineato | (nessuna norma Markdown omessa) |
Sottolineare e evidenziare non hanno equivalente Markdown nella sintassi standard. Dopo la conversione, utilizzare HTML <u> tag o classi CSS personalizzate se la piattaforma di pubblicazione le supporta.
Lista dei paesi
Word's Automatic list formatting converts cleanly:
- Bullet item one
- Bullet item two
- Nested bullet (indent 2 spaces)
1. First item
2. Second item
1. Nested numbered itemCosa rompe le liste: Disegni o numeri digitati manualmente che non sono effettivi Word. Questi sembrano elenchi visivamente ma Word li tratta come semplici paragrafi di testo. La soluzione: selezionarli in Word e applicare lo stile List Bullet o List Number.
Tabelle
Tabelle standard convertite in GitHub Aromatizzati Markdown sintassi della tabella:
| Column 1 | Column 2 | Column 3 |
|---|---|---|
| Cell A | Cell B | Cell C |
| Cell D | Cell E | Cell F |Cosa spezza i tavoli:
- Celle unite la cella che copre più colonne o righe verrà riattaccata
- Contenuto di celle multi-linee interruzioni di linee all'interno delle celle sono rimosse
- Tabelle annidate la tabella interna è appiattita a testo semplice
Per una ripartizione completa, si veda Markdown Tabelle: una guida completa.
Codice e testo preformattato
Testo formattato con un carattere monospazio (Courier New, Consolas) in mappe Word a codice in linea:
Use `console.log()` to debug.Per blocchi di codice recintati con sintassi evidenziata, applicare Words Code stile paragrafo se il modello ne ha uno, o aggiungere manualmente la tripla recinzione dopo la conversione. Vede la tabella Markdown Guida ai blocchi di codice per la sintassi completa.
Iperlink
Word I collegamenti ipertestuali convertono perfettamente:
Visit [WordToMD](https://wordtomd.org) for instant conversion.Il testo del link e l'URL sono entrambi conservati. I segnalibri (link interni all'interno dello stesso documento) potrebbero non essere convertiti se il target non esiste in Markdown.
Immagini
Le immagini sono dove la conversione Word-to-Markdown fallisce costantemente. mammoth.js può estrarre immagini incorporate come base64 dati URI, ma il comportamento predefinito è quello di notare la loro presenza nelle note di conversione. Dopo la conversione:
- Esporta immagini da Word: File → Salva come → Pagina Web (HTML)
- Indicare il loro riferimento in Markdown:
Caratteri e simboli speciali
Word spesso inserisce automaticamente caratteri Unicode speciali:
- Citazioni intelligenti (
"...") → conservati come caratteri Unicode - - No , no , no , no , no , no , no , no , no , no , no , no , no , no , no , no , no , no , no , no , no , no , no , no , no , no , no , no , no , no , no , no , no , no , no , no , no , no , no , no , no , no , no , no , no , no , no , no , no , no , no , no , no , no , no , no , no , no , no , no , no , no , no , no , no , no , no , no , no , no , no , no , no , no , no , no , no , no , no , no , no , no , no .
—) → conservati - Spazi non rotti → convertiti in spazi regolari
- Simbolo dei diritti d'autore (
©) → conservati
Se hai bisogno di uscita solo ASCII, fai un find-and-replace nel tuo editor di testo dopo la conversione.
Stili personalizzati Word
Se il documento Word utilizza stili di paragrafo personalizzati (come Callout o Warning), mammoth.js li registra come note di conversione. Vedrai messaggi come Non riconosciuto stile paragrafo: Callout. WordToMD filtra questi messaggi informativi per impostazione predefinita.
Per gestire gli stili personalizzati, hai bisogno di una configurazione locale Pandoc con un filtro personalizzato vedere Pandoc Word a Markdown per questo approccio.
Lista di controllo di formattazione prima di convertire
Applicare questa lista di controllo al documento Word prima di convertire:
- Tutte le rubriche usano Words stili integrati di rubrica 1/2/3 (non formattazione manuale)
- Le liste sono create con strumenti di lista Words (non digitati trattini/numeri)
- Le tabelle sono griglie semplici (senza celle fuse)
- Il codice utilizza un carattere monospaziale
- I collegamenti ipertestuali sono collegamenti ipertestuali reali (non solo testo sottolineato in blu)
FAQ
Perché i miei titoli si convertono in testo grasso? Hai applicato il formattamento manuale in grassetto + dimensione del carattere al posto dello stile Heading. In Word, fare clic sul paragrafo e guardare il pannello Stili dovrebbe dire Intestazione 1 non Normale.
La mia lista numerata è ricominciata a 1 nel posto sbagliato come posso risolverlo? Imposta la continuazione dell'elenco in Word: fai clic con il tasto destro sull'elenco → Continua la numerazione. Oppure modificare il Markdown direttamente dopo la conversione.
L'allineamento del tavolo sembra sbagliato in Markdown. - Cosa è successo? - Cosa?
Uso delle tabelle GFM |---| per i separatori di allineamento. WordToMD li genera automaticamente. Se il rendering non è corretto, verificare che nessuna cella contenga caratteri pipe (|) nel loro contenuto sfuggire loro come \|.
Conclusioni
Mi sto ripudiando. Formattazione da Word a Markdown si tratta principalmente di usare Word correttamente. Applicare stili di intestazione integrati, utilizzare strumenti di lista e tabella Words, e otterrai un output quasi perfetto dal Convertitore WordToMD. For edge cases — custom styles, complex tables, images — the tips above will get you the rest of the way there.