Convertitore online gratuito da AD a MD

Markdown è comunemente richiesto per i file README, i repository Git, i siti di documentazione e la modifica leggera, mentre alcuni documenti sorgente arrivano come file AsciiDoc con l'estensione più breve .ad. La conversione del sorgente ne preserva il contenuto leggibile, adattando al contempo titoli, elenchi, link, blocchi di codice e tabelle alla sintassi Markdown.

Cos'è il formato AD

Nella categoria dei file di testo, .ad identifica comunemente un file sorgente AsciiDoc. AsciiDoc è un linguaggio di markup in testo semplice per documentazione tecnica, libri, manuali, file README e pagine web; lo stesso linguaggio viene più spesso salvato con .adoc o .asciidoc.

I file AsciiDoc possono essere creati con il processore AsciiDoc originale, Asciidoctor, editor di testo e sistemi di build per la documentazione. Contengono markup sorgente leggibile, come titoli di sezione, elenchi, link, blocchi di codice sorgente, admonition, tabelle, attributi e direttive include. La sola estensione non è determinante, quindi verifica che il file contenga sintassi AsciiDoc prima di convertirlo.

Cos'è il formato MD

.md identifica un file Markdown. Markdown usa caratteri di testo semplice per titoli, enfasi, link, elenchi, citazioni, blocchi di codice e altre strutture del documento. GitHub, GitLab, generatori di siti statici, applicazioni per prendere appunti, piattaforme di documentazione ed editor di codice eseguono comunemente il rendering di Markdown.

Markdown è utile quando un documento deve rimanere facile da leggere senza un renderer, funzionare bene con il controllo versione o essere accettato come README o sorgente della documentazione. GitHub Flavored Markdown, comunemente chiamato GFM, aggiunge tabelle, elenchi di attività, testo barrato e blocchi di codice delimitati.

Come convertire effettivamente AD in MD

Utilizzando Asciidoctor e Pandoc

Per una conversione affidabile, usa Asciidoctor per interpretare il sorgente AsciiDoc e generare DocBook XML, quindi usa Pandoc per convertire quel file intermedio strutturato in Markdown GFM. Installa Asciidoctor e Pandoc, inserisci il sorgente nella directory di lavoro ed esegui:

1. Converti il file AsciiDoc in DocBook XML:
   asciidoctor -b docbook5 -o input.xml input.ad
2. Converti l'XML in Markdown:
   pandoc -f docbook -t gfm input.xml -o output.md
3. Apri output.md in un editor Markdown e controlla titoli, link, tabelle, immagini, elenchi e blocchi di codice.

Per una pipeline shell in un solo passaggio, usa:

asciidoctor -b docbook5 -o - input.ad | pandoc -f docbook -t gfm -o output.md

Utilizzando il convertitore online integrato

Puoi convertire il file gratuitamente su 101convert.com senza installare software: seleziona il formato di input AD, carica input.ad, scegli MD come formato di output, avvia la conversione e scarica il file .md risultante.

Limitazioni relative a qualità e compatibilità

La conversione modifica il markup anziché limitarsi a rinominare l'estensione. Gli attributi AsciiDoc, i contenuti condizionali, le macro, i riferimenti incrociati, i diagrammi incorporati e le strutture complesse di tabelle o admonition potrebbero richiedere modifiche manuali dopo la conversione.

Usa percorsi che rimangano validi dalla posizione del file Markdown. I riferimenti alle immagini potrebbero dover essere corretti e i ruoli o gli attributi specifici di AsciiDoc potrebbero essere eliminati perché Markdown standard non ha un equivalente. L'output GFM è generalmente il più compatibile per GitHub e GitLab, mentre Markdown di base è preferibile quando la destinazione supporta solo la sintassi originale.

Le direttive include di AsciiDoc e le sostituzioni del sorgente possono influire sul risultato generato. Esamina l'output dopo il preprocessing, soprattutto quando il sorgente utilizza file esterni, attributi personalizzati o percorsi relativi delle immagini.