Markdown

Il linguaggio Markdown (il gioco di parole in contrasto con Markup è fin troppo evidente), è un linguaggio di formattazione per testi estremamente semplice che può essere convertito in HTML tramite tools appositi. Se ti stai chiedendo come abbia fatto a scoprire questo linguaggio, sarai subito soddisfatto. Recentemente infatti, sono giunto a conoscenza di alcuni nuovi CMS per blogger e scrittori con l’esigenza di poter scrivere in modo rapido ed efficace e poter pubblicare il materiale online, senza essere vincolati da piattaforme come Blogger, WordPress.com o da servizi “malefici” come i vari Wix e compagnia bella. E così, oltre alla semplicità d’uso di tali strumenti, che non sarà l’argomento di questo post, ho scoperto questo linguaggio, nato nel lontano 2004 dalla mente di John Gruber, un blogger americano che voleva sfruttare una sintassi immediata, focalizzata sui contenuti, ma facilmente convertibile in HTML. Perchè parlare ora di un linguaggio decennale? Perchè recentemente sono stati avviati dei processi per la sua standardizzazione, al fine di evitare il proliferare di varianti sorte negli anni e ridare vitalità al progetto. Ecco quindi, in pillole, il linguaggio markdown. Il linguaggio Markdown in Pillole Vediamo ora la sintassi del linguaggio Markdown, analizzando gli elementi più importanti. Mi limito ad elencare gli elementi più comuni ed usati che, convertiti in HTML, generano una sintassi valida. **CODICE** Se dobbiamo inserire del codice, quindi senza che MarkDown interpreti i caratteri speciali, basta che andiamo a capo inseriamo **4 spazi** prima del codice che andiamo a scrivere. **.-------- Se poi come me volete modificare lo stile del codice inserito, allora basta andare nel proprio file **css** e modificare la classe **.codehilite** **Intestazioni ** **Grassetto, italic & co** Il testo si enfatizza con ```*asterischi*``` o ```_underscores_```. Il grassetto vuole doppi ```**asterischi**``` o doppi ```__underscores__```. Per combinarli insieme si usano ```**asterischi``` e ```_underscores_**```. Con la doppia tilde si fa il test ~~Barrato~~ **Elementi di Lista** Le liste ordinate (numeriche), si fanno semplicemente usando ```1.``` testo ```2.``` testo ecc… Le liste non-ordinate (pallini) vogliono l’elemento preceduto dall’asterisco (oppure dal segno ```+``` o ```-```) Per annidare un elemento di lista semplicemente si va a capo e si introduce una nuova lista **I links** **Immagini** **Elementi di codice** Il testo va inserito racchiuso da una serie di tre virgolette all'indietro **Tabelle** Decisamente il linguaggio non prevede un sistema intuitivo per la generazione di tabelle. Il linguaggio originale non le prevedeva proprio e permetteva l’uso dell’html puro per inserirle. Le nuove varianti GFM e Markdown Here supportano una sintassi piuttosto scomoda. Il mio consiglio è, ove indispensabile usare una tabella, di ricorrere ad un generatore di tabelle HTML ed utilizzare il markup generato. **Blockquotes** Le citazioni devono essere precedute dal simbolo maggiore di ```>``` **Separatori Orizzontali** Tre o più trattiini, asterischi e underscores per creare separatori orizzontali **Inserire codice HTML** Se la tua conoscenza di HTML è sufficiente, puoi inserire direttamente tag HTML, per avere un maggiore controllo sulla visualizzazione finale del testo. * testo piccolo * testo grande testo piccolo testo grande Si noti come la sintassi HTML coesista con il codice Markdown per gli elenchi puntati. E' possibile quindi inserire un mix di comandi Markdown e HTML, in modo da combinare la semplicità del primo con la completezza del secondo. Visualizzare il codice HTML o testo preformattato Se, a differenza di quanto esposto nella sezione precedente, si desidera che il codice HTML sia visualizzato esattamente come scritto e non processato dal browser, la riga deve iniziare con quattro spazi.

Un paragrafo in HTML visualizzato come codice

Si usa lo stesso sistema per visualizzare parti di programma:: print "Command-line arguments: (@ARGV)\n"; Questa modalità è spesso usata per visualizzare programmi e altri testi che potrebbero contenere caratteri che Markdown usa come indicatori di diversi tipi di formattazione. La formattazione Markdown è pertanto abolita automaticamente in questo tipo di righe:: Normalmente questa parola sarebbe in **grassetto**. Per includere i caratteri speciali nel testo normale, vedi il paragrafo seguente. **Usare i caratteri speciali** Per usare i caratteri speciali che fanno parte della 'sintassi' di Markdown, si deve precederli da un carattere 'backslash' (\). Il backslash non sarà visualizzato ma il carattere seguente sarà mostrato così come inserito, senza dar luogo a un 'comando' per Markdown: \* asterischi, non corsivo \* becomes * asterischi, non corsivo * piuttosto che *corsivo, non asterischi* che produce corsivo, non asterischi Per ulteriori info segnalo il sito : [Clicca Qui](http://www.python.it/wiki/show/SintassiMarkdown/ "Python Sintassi Markdown")