Abarone.it Logo

Markdown

Sintassi di 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.

  1. <span></span>**.--------

Se poi come me volete modificare lo stile del codice inserito, allora basta andare nel proprio file css e modificare la classe .codehilite

Intestazioni


# H1
## H2
### H3
#### H4
##### H5
###### H6

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


1. Elemento di lista ordinato
2. Altro elemento

* Elemento di lista non ordinato
* Altro elemento non ordinato

* Le liste non ordinate possono usare asterico
- O segno meno
+ O segno più

I links

[Link con titolo definito tra virgolette nella parentesi tonda] ```(https://www.google.com "Homepage di Google")```

Immagini

!****[qui ci va l']```(http://www.miosito.com/immagine.png "Qui ci va il tit)```

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

  1. <span></span>

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:

  1. <span></span>\* 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

barone.antonio@libero.it