Il linguaggio Markdown ha molti gusti, alcuni dei quali sono migliori di altri. Le lingue leggere come AsciiDoc sono facili da imparare ed estremamente utili. Ecco come si confronta.

Annuncio pubblicitario

Come probabilmente avrai visto negli articoli precedenti, qui su MakeUseOf siamo fan di Markdown What Is Markdown? 4 motivi per cui dovresti impararlo ora Cos'è Markdown? 4 motivi per cui dovresti impararlo ora Stanco degli editor HTML e WYSIWYG? Allora Markdown è la risposta per te, indipendentemente da chi tu sia. Leggi di più . Con l'apprendimento di questo formato semplice e intuitivo, puoi facilmente creare un output di bell'aspetto. Dai PDF alle pagine Web, il tuo umile file di testo diventa un documento sofisticato.

Ma Markdown non è l'unico gioco in città. Esistono numerosi altri cosiddetti linguaggi di markup leggeri simili a Markdown ma con diversi set di funzionalità. Uno di questi è Asciidoc. Se ti piace Markdown ma stai cercando un po 'di più sotto il cofano, vale la pena considerare. Ecco alcuni motivi.

Che cos'è un "linguaggio markup" comunque?

Un linguaggio di markup è un insieme di codici che, se applicato al testo in chiaro, consente di aggiungere una o più delle seguenti proprietà (tra le altre):

Definisci il testo
Struttura il testo
Descrivi il layout del testo
Decorare il testo

Un linguaggio di marcatura che incontri ogni giorno (a meno che tu non sia un eremita) è Hypertext Markup Language, o HTML. I siti web e le applicazioni che ti portano notizie e ti mostrano la tua email sono costruiti, almeno in parte, con il markup HTML. Impara HTML e CSS con questi tutorial Step by Step Impara HTML e CSS con questi tutorial Step by Step Curioso su HTML, CSS e JavaScript? Se pensi di avere un talento per imparare a creare siti Web da zero, ecco alcuni tutorial dettagliati che vale la pena provare. Leggi di più . HTML utilizza i tag come meccanismo per contrassegnare il contenuto di testo non elaborato. Ad esempio, considera il seguente snippet di HTML:

Presentazione di HTML

Ecco un paragrafo in HTML ... sappiamo che è un paragrafo perché i tag circostanti lo definiscono come uno.

Qui, il

tag specifica che tutto il testo da seguire, fino alla sua chiusura

tag, è un paragrafo. In questo senso definisce il testo come un paragrafo.

Ma si noti anche i tag ... questi spesso servono a definire il layout di una pagina web, ad esempio quanto margine ci sia dal lato dello schermo.

E i tag decoreranno la parola "paragrafo" in un font in grassetto, mentre il

i tag possono sia disporre l'intestazione (distanziandola dal testo circostante) sia definire un carattere più grande.
Il problema con alcuni linguaggi di markup (tra cui HTML) è che la digitazione manuale di questi tag è un'operazione molto noiosa. E con altri linguaggi come XML Che cos'è un file XML e quali sono i suoi usi? [Nel caso ti stavi chiedendo] Che cos'è un file XML e quali sono i suoi usi? [Nel caso ti stavi chiedendo] Leggi di più, i tag e i loro attributi costituiscono una porzione più ampia del contenuto complessivo rispetto al testo stesso! Dai uno sguardo al seguente snippet di DocBook, un dialetto XML utilizzato per creare molte pubblicazioni tecniche:
Tutto il testo in viola rappresenta i tag che dovresti digitare da solo. Il primo paragrafo non inizia fino al fondo di quell'immagine. E se non è fatto esattamente secondo lo standard DocBook, non sarai in grado di convertirlo nel bel documento PDF che di solito è l'obiettivo finale.

Inserisci la lingua Lightweight Markup

Se si desidera sfruttare i linguaggi di markup, ad esempio pubblicando una pagina HTML sul Web o convertendo un file DocBook in PDF in modo che possa essere stampato, è necessario eseguire una delle due operazioni. Da una parte puoi investire tempo imparando queste lingue dentro e fuori, scrivendole a mano, quindi ricontrollando il tuo lavoro. Oppure potresti investire denaro in uno strumento che gestisce la complessità di questi per te.

Per fortuna, alcuni sviluppatori intraprendenti hanno avuto una terza opzione. Hanno creato nuovi linguaggi di marcatura che contenevano molti (in alcuni casi la maggior parte o tutti) le caratteristiche delle controparti più pesanti, ma semplificarono notevolmente la sintassi. Queste lingue "leggere" includono il familiare Markdown What Is Markdown? 4 motivi per cui dovresti impararlo ora Cos'è Markdown? 4 motivi per cui dovresti impararlo ora Stanco degli editor HTML e WYSIWYG? Allora Markdown è la risposta per te, indipendentemente da chi tu sia. Leggi di più, Asciidoc, il formato Org-Mode di Emac e la sintassi di Mediawiki.

Le lingue di markup leggero hanno una sintassi semplice

Una caratteristica di queste lingue è che i loro "tag" (come sono) dovrebbero essere intuitivi. Diamo un'occhiata allo snippet precedente, questa volta scritto in Asciidoc:

 Introducing Asciidoc -------------------- Where are the *paragraph* tags? We dont need them... Asciidoc is smart enough to realize this is a paragraph!

Molto più leggibile, no? Iniziando dall'alto, possiamo identificare l'intestazione perché è "sottolineata" con trattini. Potresti farlo se stavi scrivendo a mano, basta disegnare una sottolineatura sotto il titolo della pagina nel tuo quaderno. Non ci sono nemmeno tag di paragrafo - Asciidoc considera qualsiasi cosa tra due righe vuote che non ha un altro markup su di esso come testo di paragrafo "semplice". Infine, gli asterischi attorno alla parola "paragrafo" indicano in grassetto. Alza la mano se hai fatto questo in un messaggio di testo per indicare la stessa identica cosa.

Ognuno ha uno o più processori corrispondenti

I linguaggi di markup "heavyweight" in genere dispongono di un'applicazione dedicata per interpretarli per te. Sul web, è il tuo browser e anche il server web che trasformerà il codice in pagine web appariscenti Tutto quello che c'è da sapere sui sistemi di gestione dei contenuti Tutto quello che c'è da sapere sui sistemi di gestione dei contenuti Per il navigatore Internet medio, visualizzazione dei contenuti è facile. Si apre un collegamento e viene visualizzata la pagina. Ma cosa sta succedendo dietro le quinte? Ecco come i tuoi CMS preferiti si prendono cura degli affari. Leggi di più . Per i documenti in XML, potrebbe essere qualcosa come Microsoft Word, che legge e scrive il suo formato DOCX Come aprire file Microsoft Word 2007 DOCX Come aprire file Microsoft Word 2007 DOCX Hai mai ricevuto uno di quei file con l'estensione .docx e si chiedeva cosa farne? Non può essere visualizzato nelle versioni precedenti di Word, quindi come è possibile aprire un file .docx ... Leggi altro (che è un altro dialetto XML). Quindi non devi mai interagire direttamente con la fonte di questi documenti, ma solo le belle facciate che le tue applicazioni ti mostrano.

Nel frattempo, i documenti scritti in linguaggi leggeri sono leggibili in forma umana (un altro inquilino), ma solo i veri nerd potrebbero pensare che siano belli. Per ottenere una buona resa, è necessario utilizzare un processore . Queste sono applicazioni che eseguiranno il tuo markup riga per riga e lo convertiranno in qualcos'altro che sembra buono. Gli stessi progetti che sviluppano il linguaggio stesso generano in genere un'utilità per utilizzarlo. Il progetto Markdown offre uno script Perl con lo stesso nome e il programma compagno di Asciidoc è scritto in Python. Inoltre, altre utilità di conversione includeranno il supporto per alcune di queste lingue. Uno di questi è l'eccellente Pandoc Come convertire facilmente tra formati di documenti in Linux Come convertire facilmente tra formati di documenti in Linux Passare a Linux può causare problemi con la compatibilità dei file. Ad esempio, i documenti non sono uguali in LibreOffice come in Word. Questa è solo una delle ragioni per cui hai bisogno di Pandoc. Ulteriori informazioni, che prenderà Markdown così come i markup leggeri, TextStrutturato, Mediawiki e Org-Mode e convertirli in PDF, DOCX, ODT e altro ancora.

formati pandoc markdown asciidoc

Il risultato è che i linguaggi di marcatura semplificati consentono di lavorare in testo semplice, il formato di dati più portatile del pianeta, ma alla fine producono comunque un risultato piacevole. Ora che sei convinto dei suoi meriti, quale lingua dovresti scegliere? Markdown è senza dubbio il più popolare e ha i suoi vantaggi (ne parleremo più avanti). Ma l'Asciidoc in particolare è un'alternativa degna. Nella prossima sezione esploreremo un paio di motivi per cui.

Confronto tra Markdown e Asciidoc

Il formato Asciidoc è stato creato per portare la semplicità leggera a DocBook, uno dei formati più comuni nella scrittura di lunga durata (soprattutto tecnica). Una delle sue affermazioni è che si tratta di una traduzione uno-a-uno, ovvero per ogni elemento di DocBook, c'è una rappresentazione corrispondente in Asciidoc. Di seguito daremo un'occhiata ad alcuni dei pro e contro di Asciidoc rispetto a Markdown.

Asciidoc copre un superset di elementi di scrittura

L'obiettivo di Markdown fin dall'inizio doveva essere un formato semplice per i web writer. In quanto tale, gli elementi di scrittura che supporta (almeno l'implemenazione originale, vedi sotto) sono focalizzati sull'automatizzazione degli aspetti più impegnativi in termini di tempo della scrittura dell'HTML (liste per esempio che richiedono il

tag per ogni articolo).
Asciidoc contiene anche questi, ma offre anche elementi DocBook più avanzati come ad es. Ammonizioni (es. "Note:" o "Info:" blocchi di callout) e layout di tabelle complesse. Ciò non significa che devi usarli tutto il tempo, ma saranno lì e disponibili se ne avrai mai bisogno.
Asciidoc è un formato unificato
Quando la popolarità di Markdown iniziò a decollare, alcuni dei suoi utenti iniziarono a imbattersi in alcune delle carenze sopra discusse. Quindi questi utenti hanno iniziato a sviluppare le proprie estensioni per risolvere questi problemi, come la possibilità di aggiungere tabelle o note a piè di pagina. Presto ci furono molti "sapori" di Markdown, inclusi (tra gli altri):
- Il sapore usato da Github per i file "Leggimi" dei progetti ospitati.
- Un sapore "esteso" nato da una porta PHP del Markdown originale con funzionalità aggiuntive in HTML.
- Un sapore chiamato "MultiMarkdown" che ha implementato molte funzionalità di scrittura più lunga, incluse citazioni, definizioni e riferimenti incrociati.
Il risultato è che il tuo documento potrebbe richiedere elementi che non sono tutti coperti da un singolo sapore. Al contrario, Asciidoc non soffre della stessa frammentazione di Markdown al momento.
Asciidoc mira a una varietà di stili di pubblicazione
Markdown è ottimo per ottenere rapidamente un post del blog fuori di testa e sulla pagina. Ma fuori dagli schemi, non è progettato per strutturare opere più lunghe, come un libro. Asciidoc è progettato per questo, e un esempio sono le sue funzioni "include". Queste istruzioni ti consentono di includere tutto il contenuto di un file in un altro:
```
 include::somefile.adoc 
```
Questo non è diverso da come i documenti master funzionano nei word processor. Ciò ti consente, ad esempio, di redigere ciascun capitolo come un file separato, quindi di "includerli" tutti in un unico file che rappresenta il libro. Quando elabori quel "file di libro", l'output sarà come se tutti i capitoli fossero stati scritti direttamente in quel documento.
Markdown è sufficiente per la maggior parte degli utenti
Markdown copre tutte le basi per una porzione più ampia di utenti. Per coloro che cercano semplicemente di fare blog o di scrivere alcune note in un formato di testo normale, Markdown supporta tutti gli elementi di cui avranno bisogno. I riferimenti incrociati non significano molto per un utente che vuole semplicemente creare un semplice promemoria o una pagina web. Potresti persino utilizzare Markdown per lavori più lunghi con layout semplici, come ad esempio un romanzo Who needs Scrivener? 5 nuove applicazioni di scrittura per Linux Chi ha bisogno di un desktop? 5 Novel Writing App per Linux Scrivener non è disponibile per Linux, quindi come farai a tenere traccia di dove vanno questi personaggi, cosa hanno fatto e come completano il loro viaggio? Bene, uno di questi strumenti dovrebbe aiutare. Leggi di più e combinali alla fine.
Markdown è meglio supportato
Poiché Markdown soddisfa le esigenze di un segmento più ampio di utenti, è finito meglio supportato in termini di:
- Gli editor WYSIWYG (come definiti da quelli che forniscono almeno un'anteprima dal vivo) sono molto più propensi a supportare Markdown.
- I servizi online, come il summenzionato Github, sono più propensi ad accettare Markdown direttamente o tramite l'uso di addon 6 Markdown Editors che funzionano bene con Google Drive 6 Markdown Editors che funzionano bene con Google Drive Markdown è il formato di modifica del testo del futuro. È più semplice, elegante e facile da usare rispetto all'HTML senza sacrificare molta potenza o flessibilità. Leggi di più .
- Nonostante i sistemi di pubblicazione come generatori di siti statici 7 motivi per abbandonare il CMS e considerare un generatore di siti statico 7 motivi per abbandonare il CMS e considerare un generatore di siti statici Per molti anni la pubblicazione di un sito Web è stata difficile per molti utenti. CMS come WordPress lo hanno cambiato, ma possono ancora essere confusi. Un'altra alternativa è un generatore di siti statici. Leggi di più spesso supporta Asciidoc con i plugin, che supportano Markdown out of the box è quasi un dato di fatto.
Sei disposto a dare una prova a Asciidoc?
Mentre Markdown è una scelta di fatto tra i linguaggi di markup leggeri, Asciidoc contiene tutti gli stessi elementi e poi alcuni. Gli extra di Asciidoc richiedono un po 'di tempo per imparare, per meglio prepararti a progetti di scrittura più grandi e complessi.
Cosa ne pensi? Sei contento della semplicità di Markdown? O sta creando il proprio flusso di lavoro di pubblicazione multicanale con Asciidoc allettante? Forse odi il testo normale e Word è completamente in te? Fateci sapere nei commenti qui sotto!