Markdown The Ins and Outs

Markdown è un linguaggio di markup incredibilmente semplice che ti permette di scrivere, usando un formato di testo semplice, facile da leggere e facile da scrivere. Questo formato può quindi, in pochi secondi, essere convertito in un altro linguaggio di markup, come HTML!

Se non ti è familiare, lascia che ti insegni oggi!

Markdown fa un lavoro fantastico per togliersi di mezzo.

Markdown fa un lavoro fantastico per togliersi di mezzo. Sono sicuro che tutti hanno, a un certo punto, enfatizzato il testo in un documento in testo semplice circondando la frase con un asterisco, * così *. È esattamente come funziona in Markdown! Fornire maggiore enfasi (in grassetto una parola) è semplice come ** raddoppiare l'asterisco **.

Non sorprende che la filosofia di Markdown sia quella di produrre contenuti, che possono essere "pubblicati così come sono, senza sembrare che siano stati contrassegnati con tag".

I vantaggi dovrebbero essere ovvi per chiunque abbia provato a scrivere contenuti basati sul Web e si sia dovuto preoccupare anche della formattazione. testo quì è semplicemente troppo difficile da digitare, una volta che il cervello è nel suo flusso - per non parlare di come la frenesia dei tag HTML che affliggono un documento possa rovinare la leggibilità mentre si prova un documento.

Esiste un certo numero di editor di Markdown, sia basati sul Web che sul desktop, ma è possibile, ovviamente, utilizzare qualsiasi vecchio editor di testo. L'unico vantaggio offerto dagli editor Markdown specifici è un'anteprima live dell'HTML generato e, in genere, un certo livello di evidenziazione della sintassi.

Se si desidera provare gli esempi di seguito, fare riferimento al convertitore Dingus basato su browser ufficiale.


Il markup

I paragrafi

Con Markdown, il testo viene automaticamente convertito in paragrafi in cui i blocchi di testo sono separati da una riga vuota. E non solo da molti
tag come WYSIWYG di giorni passati, ma reale semantico

paragrafi. È quasi come la magia nera.

 Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.

Diventa semplicemente:

Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat.

Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.

Una piccola stranezza con Markdown è come vengono gestite le interruzioni di riga singola. La filosofia di Markdown è che il browser deve gestire le interruzioni di riga e nessun altro. Quindi il seguente testo:

Lorem ipsum dolor sit amet, consectetur. Adipisicing elit, sed do eiusmod tempor incididunt.

Diventa, piuttosto stridentemente:

Lorem ipsum dolor sit amet, consectetur. Adipisicing elit, sed do eiusmod tempor incididunt.

Se tu assolutamente dovere inserisci un'interruzione di riga, viene fornita una soluzione: aggiungi semplicemente due spazi alla fine della riga precedente, in questo modo:

Lorem ipsum dolor sit amet, consectetur. Adipisicing elit, sed do eiusmod tempor incididunt.

Un certo numero di "sapori" di Markdown è in grado di gestire le interruzioni di riga come ci si aspetterebbe, ma ne parleremo più avanti.

Titoli

Inizia un paragrafo con a #, e quel paragrafo diventa un'intestazione. Il numero di # indica il numero del livello di titolo (

,

eccetera.)

# Intestazione Uno Questo è un paragrafo. Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam. ## Titolo 2 Questo è un paragrafo. Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam. ### Intestazione Tre #### Intestazione Quattro ##### Intestazione Cinque ###### Intestazione Sei

diventa:

Intestazione uno

Questo è un paragrafo. Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam.

Intestazione due

Questo è un paragrafo. Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam.

Titolo tre

Intestazione quattro

Titolo cinque
Titolo sei

È prevista anche una sintassi alternativa

e

, così:

Intestazione 1 =========== Questo è un paragrafo. Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam. Titolo due ----------- Questo è un paragrafo. Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam.

blockquotes

Una delle principali influenze di Markdown è l'e-mail in testo semplice, e questo è assolutamente ovvio, quando vedi che i blockquotes sono formattati esattamente come sono nella posta elettronica: prefisso con a >:

Questo è un paragrafo normale. > Questo è un paragrafo blockquote. > E il blockquote continua anche qui.

... Che converte in:

Questo è un paragrafo normale.

Questo è un paragrafo blockquote.

E il blockquote continua anche qui.

Codice

Puoi eliminare piccoli frammenti di codice in linea, usando il ' personaggio attorno al codice.

È possibile definire blocchi di codice più grandi semplicemente facendo rientrare il codice su un livello (almeno una scheda / quattro spazi): il livello di indentazione verrà rimosso. Markdown esegue automaticamente l'escape di tutti i caratteri speciali all'interno di un blocco di codice, il che significa che puoi tranquillamente copiare in blocchi di codice senza eseguire manualmente l'escape < a < e > a > eccetera.

Questo è un paragrafo con un po 'diCODICE' dentro.  Un altro paragrafo, ma con un blocco di codice sopra di esso.


Questo è un paragrafo con un po 'diCODICE' dentro.

 

Un altro paragrafo, ma con un blocco di codice sopra di esso.

elenchi

Un altro vero esempio di come Markdown si presenta naturalmente è nel modo in cui si specifica una lista. Basta iniziare un paragrafo con a * (o +, -) per creare una lista non ordinata. Usa i numeri, 1., 2. ecc. per gli elenchi ordinati:

Avrò bisogno di: * Serpenti * Scorpioni * Criceti Quindi, posso iniziare il mio piano per governare il mondo: 1. Aquire criceti 2. Allineare i serpenti per cavalcare criceti 3. Regolare il mondo


Io avrò bisogno:

  • serpenti
  • Scorpions
  • criceti

Quindi, posso iniziare il mio piano per governare il mondo:

  1. Criceti Aquire
  2. Allena serpenti per cavalcare criceti
  3. Governare il mondo

Elementi di testo in linea

Abbiamo già trattato il testo in corsivo e in grassetto all'inizio di questo articolo (* e **), tuttavia, puoi anche scambiare gli asterischi per i caratteri di sottolineatura, se questo è più il tuo problema:

Ecco un testo * in corsivo * e più testo _italico. Alcune ** cose in grassetto ** qui; più un __little__ bit in più.

I collegamenti sono belli e semplici in Markdown (se puoi ricordare alla memoria se sono le parentesi quadre e quelle circolari che vengono prima ...):

[Google] (http://google.com)
Google

Per visualizzare un'immagine, prefisso il codice del link con a !:

![Il logo di Google] (images_23 / markdown-the-ins-and-outs.png)
Il logo di Google

Markdown non ottiene nel tuo modo

Markdown è molto clemente, quando si tratta di rompere il suo markup e usare solo HTML. Se è necessario includere una tabella, includerla in HTML. Oppure, se preferisci scrivere i tuoi link in formato HTML, puoi farlo. Markdown è abbastanza intelligente da sapere quando intendi includere l'HTML, e funziona su di esso.

Markdown esegue anche l'escape automatico di caratteri, come &, < and > nel modulo entità HTML. Converte intelligentemente anche le comuni combinazioni di caratteri in ciò che intendi veramente.

  • Tre punti diventeranno automaticamente un'ellissi: ...
  • Due trattini diventeranno un en-dash: --
  • Le virgolette diventeranno la "fantasia", versioni arricciate di se stesse.

Flavors & GitHub Flavored Markdown

Esistono diversi "sapori" di Markdown alternativi, che estendono il set predefinito delle regole Markdown. Un'estensione comune è una semplice interruzione di linea, come descritto sopra. Uno dei più famosi sapori di Markdown è GitHub's Flavored Markdown. Questo è usato per contrassegnare l'input dell'utente ovunque sul proprio sito. Oltre ad includere un supporto per la line-breaking migliorato e un numero di personalizzazioni specifiche per GitHub, la mia caratteristica preferita è la loro alternativa alla scherma del codice, che consente anche di specificare una sintassi per l'evidenziazione. Basta circondare un blocco di codice con " su entrambi i lati, inclusa la lingua all'inizio, in questo modo:

"php "

Conversione

Il convertitore Tuts + Markdown può essere trovato qui.

Il convertitore ufficiale è scritto in Perl ed è disponibile per il download nella homepage di Markdown su Daring Fireball. Esistono anche molti altri convertitori Markdown, per una moltitudine di lingue diverse - da C ... a Ruby ... a JavaScript ... a PHP. Un elenco completo di implementazioni può essere trovato su Wikipedia.

Un'importante implementazione di Ruby è RedCarpet, basata sulla libreria C, Sundown, che fornisce un modo molto semplice per personalizzare l'output dell'HTML generato per produrre il proprio "sapore" di Markdown.

Recentemente, ho usato questa libreria per creare un convertitore Markdown, che accetta GitHub Flavored Markdown (per consentire di specificare un linguaggio di codice per l'evidenziazione della sintassi) e restituisce l'HTML convertito nello stile specifico richiesto dai siti Tuts +. Il convertitore Tuts + Markdown può essere trovato qui. Se hai mai scritto un tutorial per questo sito, sicuramente usalo!

In realtà, questo articolo è stato scritto in Markdown, utilizzando il popolare editor Mou Markdown per OSX.