Il existe de nombreux langages de définition de document. Les plus connus
sont sûrement Tex
et DocBook. Le résultat fait
consensus, on obtient des documents professionnels. Néanmoins l'apprentissage
de la syntaxe peut parfois rebuter et la lecture de source (par opposition au
document produit) Tex et DocBook est
loin d'être facile.
En effet, Tex
est rempli de slashes et d'accolades, et pour ce qui est de DocBook et bien c'est un tas de
balises XML (tag soup en jargon anglophone) à tout va. Face à cela, il existe
un langage nommé Markdown. Un langage plus
léger, moins puissant (pas de formule mathématique par exemple) mais qui a le
grand avantage d'être facilement lisible. Markdown est tellement
lisible, que vous pouvez très bien vous contenter des sources si vous souhaitez
rédiger un document au format texte.
Viens ensuite la possibilité de produire du tex, du pdf, html et plein
d'autres formats. Pour ce faire il suffit d'utiliser l'outil pandoc qui se veut être le couteau
suisse de markdown.
Voici un exemple de texte en markdown :
A First Level Header
====================
A Second Level Header
---------------------
Now is the time for all good men to come to
the aid of their country. This is just a
regular paragraph.
The quick brown fox jumped over the lazy
dog's back.
### Header 3
> This is a blockquote.
>
> This is the second paragraph in the blockquote.
>
> ## This is an H2 in a blockquote
Le rendu en HTML étant le suivant :
A First Level Header
A Second Level Header
Now is the time for all good men to come to the aid of their country. This
is just a regular paragraph.
The quick brown fox jumped over the lazy dog's back.
Header 3
This is a blockquote.
This is the second paragraph in the blockquote.
This is an H2 in a blockquote
Vous l'aurez compris, markdown est un point de
départ qu'il est facile de pendre et d'apprendre. Ensuite les formats de sortie
sont tellement nombreux, que chacun peut trouver son bonheur.
L'exemple est issu de site officiel : markdown
basics
