Guida alla formattazione Markdown

Codice e testo preformattato

Indenta il testo di quattro spazi per creare un blocco <pre><code>:

    printf("goodbye world!");  /* questa stringa
                                  è scritta in c */

Il testo è mostrato con un font monospaziato. I primi quattro caratteri bianchi sono automaticamente rimossi, tutti gli altri saranno invece mantenuti.

Qualsiasi codice HTML è automaticamente ignorato all'interno di un blocco di codice:

    <blink>
       you would hate this if it weren't
       wrapped in a code block.
    </blink>

Elementi di codice

Usa backtick per creare elementi di <code> all'interno di una frase:

press the `<tab>` key, then type a `$`.

(Il carattere backtick si trova in alto a sinistra nella maggior parte delle tastiere)

Come i blocchi di codice, anche gli elementi di codice sono mostrati con un carattere monospaziato. Sintassi Markdown e HTML sono ignorate all'interno di un elemento di codice. A differenza dei blocchi di codice, gli elementi di codice richiedono l'escape manuale di qualsiasi tag HTML all'interno.

Ritorni a capo

Termina una riga con due spazi per aggiungere un ritorno a capo <br/>

how do i love thee?    
let me count the ways

Corsivo e Grassetto

*this is italicized*, and so is _this_.
**this is bold**, and so is __this__.
use ***italics and bold together*** if you ___have to___.

Link

Ci sono 3 modi per creare un collegamento:

here's an inline link to [google](http://www.google.com/).
here's a reference-style link to [google][1].
here's a very readable link to [yahoo!][yahoo].

[1]: http://www.google.com/
[yahoo]: http://www.yahoo.com/

La definizione del link può essere inserita in qualsiasi posto all'interno del documento, prima o dopo il suo utilizzo. I simboli usati nella definizione [1] e [yahoo] possono essere una qualsiasi stringa e non fanno distinzione tra maiuscole/minuscole: [yahoo] è lo stesso di [Yahoo].

Inoltre, il sistema converte automaticamente in link qualsiasi URL.

i often visit http://stackoverflow.com.

Intestazioni

Sottolinea il testo per creare una intestazione di primo (<h1>) o secondo (<h2>) livello:

header 1
========

header 2
--------

Il numero di caratteri = o - non è importante ma deve essere sufficiente a sottolineare il testo completo dell'intestazione.

In alternativa, puoi usare la sintassi "stile hash". Ogni cancelletto identifica un livello

.

# header 1 #
## header 2 ##
### header 3 ###

Il carattere # finale è opzionale.

Linee orizzontali

Crea una linea orizzontale <hr/> inserendo tree o più apici, asterischi o trattini.

rule #1
---
rule #2
*******
rule #3
___

Elenchi

Un elenco puntato <ul>:

- use a minus sign for a bullet
+ or plus sign
* or an asterisk

Un elenco numerato <ol>:

1. numbered lists are easy
2. markdown keeps track of the numbers for you
7. so this will be item 3.

Un elenco con doppia interlinea:

- this list gets wrapped in <p> tags
 
- so there will be extra space between items

Elenco annidato

Per creare più elenchi annidati, rientra il secondo elenco di 4 spazi:

1. lists in a list item:
    - indented four spaces.
        * indented eight spaces.
    - four spaces again.
2.  multiple paragraphs in a list items:
    it's best to indent the paragraphs four spaces
    you can get away with three, but it can get
    confusing when you nest other things.
    stick to four.
 
    we indented the first line an extra space to align
    it with these paragraphs.  in real use, we might do
    that to the entire list so that all items line up.
 
    this paragraph is still part of the list item, but it looks messy to humans.  so it's a good idea to wrap your nested paragraphs manually, as we did with the first two.
 
3. blockquotes in a list item:
 
> skip a line and
    > indent the >'s four spaces.
 
4. preformatted text in a list item:
 
        skip a line and indent eight spaces.
        that's four spaces for the list
        and four to trigger the code block.

Citazioni

Aggiungi un > all'inizio di ogni riga per creare una citazione <blockquote>.

> the syntax is based on the way email programs
> usually do quotations. you don't need to hard-wrap
> the paragraphs in your blockquotes, but it looks much nicer if you do.  depends how lazy you feel.

Immagini

Le immagini funzionano esattamente con i link, ma contengono un punto esclamativo all'inizio.

![valid xhtml](http://w3.org/icons/valid-xhtml10).

Così come i link, anche le immagini possono usare la sintassi per riferimento.

this page is ![valid xhtml][checkmark].

[checkmark]: http://w3.org/icons/valid-xhtml10
             "what are you smiling at?"

Note: Markdown attualmente non supporta la seguente scorciatoia per le immagini:

here's a broken ![checkmark].

Ma puoi utilizzare una versione leggermente meno concisa con riferimento implicito.

this ![checkmark][] works.

Puoi anche scegliere di usare la sintassi HTML standard che consente di specificare anche ulteriori attributi per l'immagine.

<img src="http://example.com/sample.png" width="100" height="100">

HTML

La sintassi supporta un numero limitato di elementi HTML.

 strikethrough humor is <strike>funny</strike>.

Gli elementi HTML hanno alcune limitazioni:

1. devono essere separati dal resto del testo da una riga vuota
2. il tag di apertura e chiusura non devono essere inseriti in una stringa indentata
3. markdown non può essere usato all'interno di elementi HTML

<pre>
    you can <em>not</em> use markdown in here.
</pre>

Maggiori Dettagli

Per ulteriori dettagli visita la documentazione ufficiale della sintassi Markdown.