Markdown

Markdown
Estensione.md, .markdown[1]
Tipo MIMEtext/markdown
Uniform Type Identifier (UTI)net.daringfireball.markdown
SviluppatoreJohn Gruber
ProprietarioJohn Gruber
LicenzaLicenza BSD
1ª pubblicazione9 marzo 2004[2][3]
Ultima versione1.0.1[4] (17 dicembre 2004)
Tipolinguaggio di markup
Estensione diFile di testo
Formato aperto?Sì
Sito webdaringfireball.net/projects/markdown/

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 usando un tool omonimo.[4] 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.

Storia

John Gruber, con il contributo sostanziale di Aaron Swartz[2], 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”.[4]

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[5], diversamente dal testo formattato con un linguaggio di markup come Rich Text Format (RTF) o HTML, che mostrano chiaramente istruzioni di formattazione.

Gruber ha scritto uno script in Perl chiamato Markdown.pl che converte un testo marcato in un XHTML o HTML ben formattato e sostituisce i segni di minore ('<') e la e commerciale con le relative entità. Può essere usato da solo oppure come plugin di Blosxom o Movable Type, oppure come un filtro di testo per BBEdit.[4] È distribuito con una licenza BSD.[6][7][8]

Da allora, Markdown è stato re-implementato da altri come un modulo di Perl disponibile su CPAN (Text::Markdown), e in vari altri linguaggi di programmazione.

Siti come GitHub, reddit, Diaspora, Stack Exchange, OpenStreetMap, e SourceForge usano varianti di Markdown per facilitare le discussioni fra gli utenti.[9][10][11][12]

Standardizzazione e CommonMark

Non esiste uno standard univocamente definito per Markdown, a eccezione dell'articolo originale di John Gruber e della sua implementazione che alcuni considerano una forma del cosiddetto abandonware.[13][14] Questo ha portato a una frammentazione del linguaggio dato che differenti produttori ne scrivono la propria variante per correggere errori o per aggiungere funzionalità non previste originariamente.

Dal 2012 fino al 2014, un gruppo di persone capeggiato da Jeff Atwood ha portato avanti quella che Atwood ha descritto come uno "sforzo di standardizzazione".[15] Un sito web di comunità ora si prefigge l'obiettivo di "documentare vari strumenti e risorse disponibili, di documentare autori e sviluppatori così come implementatori delle varie implementazioni di markdown".[16] Nel settembre del 2014 Gruber ha obiettato sull'uso di "Markdown" nel nome di questo gruppo e del suo prodotto che per questa ragione è stato rinominato in "CommonMark".[17][18]

È anche disponibile uno strumento (chiamato Babelmark2[19]) che "confronta l'output delle varie implementazioni" per "promuovere la discussione su come e se alcuni aspetti poco chiari delle specifiche di Markdown debbano essere chiarite".[20] Gruber ha fatto notare che una completa standardizzazione sarebbe un errore: "Siti (e persone) diverse hanno necessità differenti. Nessuna sintassi farebbe tutti felici."[21]

Presso la Internet Engineering Task Force è in corso la procedura per standardizzare lo Internet media type text/markdown, indipendente dalla sintassi. Si pianifica di sottoporre al IESG la Internet-Draft, draft-ietf-appsawg-text-markdown, nell'aprile 2015. La comunità che ruota intorno a Markdown è invitata a sottoporre proposte per guidare il processo di standardizzazione.

Estensioni

Una quantità di linguaggi di markup leggeri estendono Markdown implementando caratteristiche aggiuntive (come tabelle, note a piè pagina, liste di definizioni e Markdown all'interno di blocchi HTML) originariamente non disponibili con la sintassi di Markdown: esempi di questi linguaggi sono Markdown Extra, MultiMarkdown, Maruku,[22] Kramdown e l'estensione Pandoc.[23] In alcuni casi, questo ha lo scopo di permettere la conversione in formati alternativi al HTML come LaTeX, RTF e DocBook.

Molte implementazioni omettono intenzionalmente il supporto all'enfasi all'interno di parole. Nella implementazione originale di Markdown, un costrutto come my_long_variable è interpretato come una richiesta di aggiungere enfasi alle lettere "long" a metà della parola. Molti utenti trovano questo comportamento confusionale, per questa ragione molte implementazioni successive come PHP Markdown e Python Markdown non implementano questa caratteristica per impostazione di default.[24]

Lo scritto "Thoughts on Markdown" riporta che John Gruber, sviluppatore originario, non ha risposto alle discussioni a proposito delle estensioni a Markdown e dichiara "Markdown sta cambiando, con o senza di lui"..

Esempi

Testo con sintassi MarkdownIl codice HTML corrispondente generato da un processore MarkdownIl testo visualizzato nel browser
 Heading
 =======
 
 Sub-heading
 -----------
 
 ### Another deeper heading

<h1>Heading</h1>

<h2>Sub-heading</h2>

<h3>Another deeper heading</h3>
Heading
Sub-heading
Another deeper heading
 Paragraphs are separated
 by a blank line.
 
 Leave 2 spaces at the end of a line to do a 
 line break

<p>Paragraphs are separated
by a blank line.</p>

<p>Leave 2 spaces at the end of a line to do a<br />
line break</p>
Paragraphs are separated

by a blank line.

Leave 2 spaces at the end of a line to do a
line break

 Text attributes *italic*, **bold**, 
 `monospace`, ~~strikethrough~~ .

<p>Text attributes <em>italic</em>, <strong>bold</strong>,
<code>monospace</code>, <s>strikethrough</s>.</p>
Text attributes italic, bold,

monospace, strikethrough.

 A [link](http://example.com).
 <<<   No space between ] and (  >>>

<p>A <a href="http://example.com">link</a>.</p>
A link.
 Shopping list:
 
   * apples
   * oranges
   * pears
 
 Numbered list:
 
   1. apples
   2. oranges
   3. pears

<p>Shopping list:</p>

<ul>
<li>apples</li>
<li>oranges</li>
<li>pears</li>
</ul>

<p>Numbered list:</p>

<ol>
<li>apples</li>
<li>oranges</li>
<li>pears</li>
</ol>
Shopping list:
  • apples
  • oranges
  • pears

Numbered list:

  1. apples
  2. oranges
  3. pears
 The rain---not the reign---in
 Spain.

<p>The rain&mdash;not the
reign&mdash;in Spain.</p>
The rain—not the reign—in Spain.
![Image](Icon-pictures.png "icon")

<p><img alt="Image" title="icon" src="Icon-pictures.png" /></p>

Here's a simple footnote,[^1] and here's a longer one.[^bignote]

[^1]: This is the first footnote.

[^bignote]: Here's one with multiple paragraphs and code.

    Indent paragraphs to include them in the footnote.

    `{ my code }`

    Add as many paragraphs as you like.
Here’s a simple footnote,1 and here’s a longer one.2
  1. This is the first footnote. ↩
  2. Here’s one with multiple paragraphs and code. Indent paragraphs to include them in the footnote. { my code } Add as many paragraphs as you like. ↩

Integrazioni

Per quanto Markdown sia un linguaggio a markup minimale, semplice da leggere e modificabile con un normale editor di testi, per tutte le maggiori piattaforme esistono editor specificamente progettati per visualizzare le anteprime con gli stili applicati. Inoltre esistono plugin per la syntax highlighting incorporati in emacs, gedit, e vim.

Implementazioni

Implementazioni di Markdown sono disponibili per molti diversi framework, piattaforme e linguaggi.

Test suites

Note

  1. ↑ (EN) RFC 7763 — The text/markdown Media Type, su datatracker.ietf.org, Internet Engineering Task Force.
  2. 1 2 (EN) Aaron Swartz, Markdown, su Aaron Swartz: The Weblog, 19 marzo 2004.
  3. ↑ (EN) Markdown 1.0b1, su Daring Fireball (archiviato dall'url originale l'11 marzo 2004).
  4. 1 2 3 4 (EN) Markdown, su Daring Fireball (archiviato il 3 gennaio 2005).
  5. ↑ (EN) Philosophy, su Markdown: Syntax, Daring Fireball.
  6. ↑ Markdown: License, su Daring Fireball. URL consultato il 25 aprile 2014.
  7. ↑ (EN) MarsEdit 2.3 ties the knot with Tumblr support, su Ars Technica. URL consultato l'11 agosto 2009.
  8. ↑ (EN) Review: Practical Django Projects, su Ars Technica. URL consultato l'11 agosto 2009.
  9. ↑ GitHub Flavored Markdown, su help.github.com, github.com. URL consultato il 29 marzo 2013.
  10. ↑ Reddit markdown primer. Or, how do you do all that fancy formatting in your comments, anyway?, su reddit.com. URL consultato il 29 marzo 2013.
  11. ↑ Markdown Editing Help, su stackoverflow.com, https://stackoverflow.com/. URL consultato l'11 aprile 2014.
  12. ↑ SourceForge: Markdown Syntax Guide, su sourceforge.net. URL consultato il 10 maggio 2013.
  13. ↑ Jeff Atwood, Responsible Open Source Code Parenting, su codinghorror.com. URL consultato il 25 aprile 2014 (archiviato dall'url originale il 21 febbraio 2014).
  14. ↑ Trouble with parentheses in Markdown hyperlinks, su six.pairlist.net, 17 ottobre 2012. URL consultato il 25 aprile 2014.
  15. ↑ Jeff Atwood, The Future of Markdown, su codinghorror.com, 25 ottobre 2012. URL consultato il 25 aprile 2014 (archiviato dall'url originale l'11 febbraio 2014).
  16. ↑ Markdown Community Page, su markdown.github.io. URL consultato il 25 aprile 2014.
  17. ↑ Standard Markdown is now Common Markdown, su blog.codinghorror.com, Jeff Atwood. URL consultato il 7 ottobre 2014.
  18. ↑ Standard Markdown Becomes Common Markdown then CommonMark, su InfoQ. URL consultato il 7 ottobre 2014.
  19. ↑ Babelmark 2 - Compare markdown implementations, su johnmacfarlane.net. URL consultato il 25 aprile 2014.
  20. ↑ Babelmark 2 - FAQ, su johnmacfarlane.net. URL consultato il 25 aprile 2014.
  21. ↑ John Gruber, Twitter post, su twitter.com. URL consultato il 6 settembre 2014.
  22. ↑ Maruku, su maruku.rubyforge.org. URL consultato il 3 maggio 2015 (archiviato dall'url originale il 24 aprile 2015).
  23. ↑ Pandoc Markdown, su johnmacfarlane.net, Pandoc. URL consultato il 7 ottobre 2014.
  24. ↑ Markdown Discuss, su six.pairlist.net, Markdown-Discuss. URL consultato il 7 ottobre 2014.
  25. ↑ Doxygen Manual: Markdown support, su stack.nl, 21 aprile 2014. URL consultato il 25 aprile 2014.
  26. ↑ file 462 lines (396 sloc) 12.572 kb, rstudio/src/cpp/core/markdown/Markdown.cpp at master · rstudio/rstudio · GitHub, su github.com. URL consultato il 25 aprile 2014.
  27. ↑ JetBrains Plugin Repository :: Markdown, su plugins.jetbrains.com. URL consultato il 25 aprile 2014 (archiviato dall'url originale il 27 aprile 2014).
  28. ↑ nicoulaj/idea-markdown ¡ GitHub, su github.com, 1º dicembre 2013. URL consultato il 25 aprile 2014.
  29. ↑ Writing on GitHub, su help.github.com, Github, Inc.. URL consultato il 9 luglio 2014.
  30. ↑ Pandoc's markdown, su johnmacfarlane.net. URL consultato il 5 agosto 2014.
  31. ↑ Discount - a C implementation of the Markdown markup language, su pell.portland.or.us. URL consultato il 1º novembre 2014.
  32. ↑ Md2doc - Markdown2Html2Docbook XSLT 2.0 conversion tool, su github.com. URL consultato il 25 novembre 2014.

Voci correlate

Linguaggi a marcatori leggeri simili:

Altri progetti

Collegamenti esterni

Controllo di autoritàLCCN (EN) sh2015002740 · J9U (EN, HE) 987007415877105171
Questa voce è stata pubblicata da Wikipedia. Il testo è rilasciato in base alla licenza Creative Commons Attribution-Share Alike 4.0, salvo diversa indicazione. Potrebbero essere applicate clausole aggiuntive per i file multimediali.