--- language: markdown contributors: - ["Dan Turkel", "http://danturkel.com/"] - ["Jacob Ward", "http://github.com/JacobCWard/"] translators: - ["Jacopo Andrea Giola", "http://geekpanda.net"] - ["Ale46", "https://github.com/Ale46"] filename: markdown-it.md lang: it-it --- Markdown è stato creato da John Gruber nel 2004. Il suo scopo è quello di essere una sintassi facile da leggere e scrivere, e che può essere convertita in HTML (ad oggi anche in molti altri formati). Markdown varia nelle sue implementazioni da un parser all'altro. Questa guida cercherà di chiarire quali caratteristiche esistono a livello globale o quando sono disponibili solo per un determinato parser. - [Elementi HTML](#elementi-html) - [Titoli](#titoli) - [Stili di testo semplici](#stili-di-testo-semplici) - [Paragrafi](#paragrafi) - [Liste](#liste) - [Estratti di codice](#estratti-di-codice) - [Linea orizzontale](#linea-orizzontale) - [Links](#links) - [Immagini](#immagini) - [Miscellanea](#miscellanea) ## Elementi HTML Markdown è un superset di HTML, quindi ogni file HTML è a sua volta un file Markdown valido. ```markdown ``` ## Titoli Potete creare gli elementi HTML da `

` a `

` facilmente, basta che inseriate un egual numero di caratteri cancelletto (#) prima del testo che volete all'interno dell'elemento ```markdown # Questo è un

## Questo è un

### Questo è un

#### Questo è un

##### Questo è un

###### Questo è un
``` Markdown inoltre fornisce due alternative per indicare gli elementi h1 e h2 ```markdown Questo è un h1 ============== Questo è un h2 -------------- ``` ## Stili di testo semplici Il testo può essere stilizzato in corsivo o grassetto usando markdown ```markdown *Questo testo è in corsivo.* _Come pure questo._ **Questo testo è in grassetto.** __Come pure questo.__ ***Questo testo è stilizzato in entrabmi i modi.*** **_Come questo!_** *__E questo!__* ``` In Github Flavored Markdown, che è utilizzato per renderizzare i file markdown su Github, è presente anche lo stile barrato: ```markdown ~~Questo testo è barrato.~~ ``` ## Paragrafi ```markdown I paragrafi sono una o più linee di testo adiacenti separate da una o più righe vuote. Questo è un paragrafo. Sto scrivendo in un paragrafo, non è divertente? Ora sono nel paragrafo 2. Anche questa linea è nel paragrafo 2! Qui siamo nel paragrafo 3! ``` Se volete inserire l'elemento HTML `
`, potete terminare la linea con due o più spazi e poi iniziare un nuovo paragrafo. ```markdown Questa frase finisce con due spazi (evidenziatemi per vederli). C'è un
sopra di me! ``` Le citazioni sono semplici da inserire, basta usare il carattere >. ```markdown > Questa è una citazione. Potete > mandare a capo manualmente le linee e inserire un `>` prima di ognuna, oppure potete usare una sola linea e lasciare che vada a capo automaticamente. > Non c'è alcuna differenza, basta che iniziate ogni riga con `>`. > Potete utilizzare anche più di un livello >> di indentazione! > Quanto è comodo? ``` ## Liste Le liste non ordinate possono essere inserite usando gli asterischi, il simbolo più o dei trattini ```markdown * Oggetto * Oggetto * Altro oggetto oppure + Oggetto + Oggetto + Un altro oggetto oppure - Oggetto - Oggetto - Un ultimo oggetto ``` Le liste ordinate invece, sono inserite con un numero seguito da un punto. ```markdown 1. Primo oggetto 2. Secondo oggetto 3. Terzo oggetto ``` Non dovete nemmeno mettere i numeri nell'ordine giusto, markdown li visualizzerà comunque nell'ordine corretto, anche se potrebbe non essere una buona idea. ```markdown 1. Primo oggetto 1. Secondo oggetto 1. Terzo oggetto ``` (Questa lista verrà visualizzata esattamente come quella dell'esempio prima) Potete inserire anche sotto liste ```markdown 1. Primo oggetto 2. Secondo oggetto 3. Terzo oggetto * Sotto-oggetto * Sotto-oggetto 4. Quarto oggetto ``` Sono presenti anche le task list. In questo modo è possibile creare checkbox in HTML. ```markdown I box senza la 'x' sono checkbox HTML ancora da completare. - [ ] Primo task da completare. - [ ] Secondo task che deve essere completato. Il box subito sotto è una checkbox HTML spuntata. - [x] Questo task è stato completato. ``` ## Estratti di codice Potete inserire un estratto di codice (che utilizza l'elemento ) indentando una linea con quattro spazi oppure con un carattere tab. ```markdown Questa è una linea di codice Come questa ``` Potete inoltre inserire un altro tab (o altri quattro spazi) per indentare il vostro codice ```markdown my_array.each do |item| puts item end ``` Codice inline può essere inserito usando il carattere backtick ` ```markdown Giovanni non sapeva neppure a cosa servisse la funzione `go_to()`! ``` In Github Flavored Markdown, potete inoltre usare una sintassi speciale per il codice ```markdown ```ruby def foobar puts "Hello world!" end `` ` ``` Se usate questa sintassi, il testo non richiederà di essere indentato, inoltre Github userà l'evidenziazione della sintassi del linguaggio specificato dopo i ``` iniziali ## Linea orizzontale Le linee orizzontali (`
`) sono inserite facilmente usanto tre o più asterischi o trattini, con o senza spazi. ```markdown *** --- - - - **************** ``` ## Links Una delle funzionalità migliori di markdown è la facilità con cui si possono inserire i link. Mettete il testo da visualizzare fra parentesi quadre [] seguite dall'url messo fra parentesi tonde () ```markdown [Cliccami!](http://test.com/) ``` Potete inoltre aggiungere al link un titolo mettendolo fra doppi apici dopo il link ```markdown [Cliccami!](http://test.com/ "Link a Test.com") ``` La sintassi funziona anche con i path relativi. ```markdown [Vai a musica](/music/). ``` Markdown supporta inoltre anche la possibilità di aggiungere i link facendo riferimento ad altri punti del testo. ```markdown [Apri questo link][link1] per più informazioni! [Guarda anche questo link][foobar] se ti va. [link1]: http://test.com/ "Bello!" [foobar]: http://foobar.biz/ "Va bene!" ``` l titolo può anche essere inserito in apici singoli o in parentesi, oppure omesso interamente. Il riferimento può essere inserito in un punto qualsiasi del vostro documento e l'identificativo del riferimento può essere lungo a piacere a patto che sia univoco. Esiste anche un "identificativo implicito" che vi permette di usare il testo del link come id. ```markdown [Questo][] è un link. [Questo]: http://thisisalink.com/ ``` Ma non è comunemente usato. ## Immagini Le immagini sono inserite come i link ma con un punto esclamativo inserito prima delle parentesi quadre! ```markdown ![Qeusto è il testo alternativo per l'immagine](http://imgur.com/myimage.jpg "Il titolo opzionale") ``` E la modalità a riferimento funziona esattamente come ci si aspetta ```markdown ![Questo è il testo alternativo.][myimage] [myimage]: relative/urls/cool/image.jpg "Se vi serve un titolo, lo mettete qui" ``` ## Miscellanea ### Auto link ```markdown è equivalente ad [http://testwebsite.com/](http://testwebsite.com/) ``` ### Auto link per le email ```markdown ``` ### Caratteri di escaping ```markdown Voglio inserire *questo testo circondato da asterischi* ma non voglio che venga renderizzato in corsivo, quindi lo inserirò così: \*questo testo è circondato da asterischi\*. ``` ### Combinazioni di tasti In Github Flavored Markdown, potete utilizzare il tag per raffigurare i tasti della tastiera. ```markdown Il tuo computer è crashato? Prova a premere Ctrl+Alt+Canc ``` ### Tabelle Le tabelle sono disponibili solo in Github Flavored Markdown e sono leggeremente complesse, ma se proprio volete inserirle fate come segue: ```markdown | Col1 | Col2 | Col3 | | :------------------- | :------: | -----------------: | | Allineato a sinistra | Centrato | Allineato a destra | | blah | blah | blah | ``` oppure, per lo stesso risultato ```markdown Col 1 | Col2 | Col3 :-- | :-: | --: È una cosa orrenda | fatela | finire in fretta ``` --- Per altre informazioni, leggete il post ufficiale di John Gruber sulla sintassi [qui](http://daringfireball.net/projects/markdown/syntax) e il magnifico cheatsheet di Adam Pritchard [qui](https://github.com/adam-p/markdown-here/wiki/Markdown-Cheatsheet).