Markdown è un linguaggio di markup con una sintassi del testo semplice progettata in modo che possa essere convertita in HTML e in molti altri formati.
Markdown è spesso usato per formattare file README, per scrivere messaggi in forum di discussioni e per creare testo formattato utilizzando un editor di testo semplice.
John Gruber, con il contributo sostanziale di Aaron Swartz, ha creato il linguaggio Markdown nel 2004 con l'obiettivo di permettere alle persone “di scrivere usando un formato testo semplice da scrivere e leggere e, opzionalmente, di convertirlo in XHTML (o HTML) strutturalmente valido”.
Prendendo spunti dalle convenzioni esistenti per scrivere testo semplice nelle email, come setext, il linguaggio è stato progettato per essere leggibile così com'è, senza che sembri marcato con tags o istruzioni di formattazione[8], diversamente dal testo formattato con un linguaggio di markup come Rich Text Format (RTF) o HTML, che mostrano chiaramente istruzioni di formattazione.
Markdown è utilizzato ad esempio per i files README su GitHub.
Intestazioni
# This is an <h1> tag
## This is an <h2> tag
### This is an <h3> tag
###### This is an <h6> tag
This is an <h1> tag
This is an <h2> tag
This is an <h3> tag
This is an <h6> tag
Enfasi
*This text will be italic*
_This will also be italic_
**This text will be bold**
__This will also be bold__
_You **can** combine them_
This text will be italic This will also be italic
This text will be bold This will also be bold
You can combine them
Interruzioni di linea e rientri
I paragrafi sono divisi da una linea vuota ( cioè da due interruzioni di linea).
Per andare a capo rimanendo nello stesso paragrafo inserire due spazi prima
di andare a capo e continuare a scrivere.
Questa è una linea separata nello stesso paragrafo.
Liste
Non ordinate
* Item 1
* Item 2
* Item 2a
* Item 2b
- Item 1
- Item 2
- Item 2a
- Item 2b
Ordinate
1. Item 1
1. Item 2
1. Item 3
1. Item 3a
1. Item 3b
- Item 1
- Item 2
- Item 3
- Item 3a
- Item 3b
1. First ordered list item
2. Another item
⋅⋅* Unordered sub-list.
1. Actual numbers don't matter, just that it's a number
⋅⋅1. Ordered sub-list
4. And another item.
⋅⋅⋅You can have properly indented paragraphs within list items. Notice the blank line above, and the leading spaces (at least one, but we'll use three here to also align the raw Markdown).
* Unordered list can use asterisks
- Or minuses
+ Or pluses
- First ordered list item
- Another item ⋅⋅* Unordered sub-list.
- Actual numbers don't matter, just that it's a number ⋅⋅1. Ordered sub-list
- And another item.
⋅⋅⋅You can have properly indented paragraphs within list items. Notice the blank line above, and the leading spaces (at least one, but we'll use three here to also align the raw Markdown).
- Unordered list can use asterisks
- Or minuses
- Or pluses
Immagini
Format: 
Collegamenti
[GitHub](http://github.com)
Citazioni
As Kanye West said:
> We're living the future so
> the present is our past.
As Kanye West said:
We're living the future so the present is our past.
Codice in linea
I think you should use an
`<addr>` element here instead.
I think you should use an
<addr> element here instead.
Blocchi di codice
Racchiudere il codice tra 3 apici inversi ```
In alternativa rientrare il testo con 4 spazi
var s = "JavaScript syntax highlighting";
alert(s);
s = "Python syntax highlighting"
print s
No language indicated, so no syntax highlighting.
But let's throw in a <b>tag</b>.
Estensioni Github
Github usa una variante (“dialetto”) di Markdown con alcune estensioni: illuminazione sintassi, liste di tasks, tabelle, collegamenti automatici
collegamenti automatici
http://github.com - automatic!
Tabelle
Si separano le colonne con | e l'intestazione dalle altre righe con almeno tre -
First Header | Second Header
------------ | -------------
Content from cell 1 | Content from cell 2
Content in the first column | Content in the second column
diventa
| First Header | Second Header |
|---|---|
| Content from cell 1 | Content from cell 2 |
| Content in the first column | Content in the second column |
Liste di compiti o di controlli
(tasklists, checklists)
- [x] @mentions, #refs, [links](), **formatting**, and <del>tags</del> supported
- [x] list syntax required (any unordered or ordered list supported)
- [x] this is a complete item
- [ ] this is an incomplete item
diventa
- @mentions, #refs, links, formatting, and tags supported
- list syntax required (any unordered or ordered list supported)
- this is a complete item
- this is an incomplete item
Esempi
It's very easy to make some words **bold** and other words *italic* with Markdown. You can even [link to Google!](http://google.com)
It's very easy to make some words bold and other words italic with Markdown. You can even link to Google!
Sometimes you want numbered lists:
1. One
2. Two
3. Three
Sometimes you want bullet points:
* Start a line with a star
* Profit!
Alternatively,
- Dashes work just as well
- And if you have sub points, put two spaces before the dash or star:
- Like this
- And this
Sometimes you want numbered lists:
- One
- Two
- Three
Sometimes you want bullet points:
- Start a line with a star
- Profit!
Alternatively,
- Dashes work just as well
- And if you have sub points, put two spaces before the dash or star:
- Like this
- And this
# Documenti strutturati
Sometimes it's useful to have different levels of headings to structure your documents. Start lines with a `#` to create headings. Multiple `##` in a row denote smaller heading sizes.
### This is a third-tier heading
You can use one `#` all the way up to `######` six for different heading sizes.
If you'd like to quote someone, use the > character before the line:
> Coffee. The finest organic suspension ever devised... I beat the Borg with it.
> - Captain Janeway
Documenti strutturati
Sometimes it's useful to have different levels of headings to structure your documents. Start lines with a # to create headings. Multiple ## in a row denote smaller heading sizes.
This is a third-tier heading
You can use one # all the way up to ###### six for different heading sizes.
If you'd like to quote someone, use the > character before the line:
Coffee. The finest organic suspension ever devised… I beat the Borg with it.
- Captain Janeway
Strumenti
L'editor vim supporta markdown con illuminazione della sintassi ed il preview con il plugin instant-markdown https://github.com/suan/vim-instant-markdown
Tra gli editor specializzati ReText e Remarkable