Pour éviter de laisser «flotter» les figures avec pandoc et markdown ... c'est capilotracté :(

Mais ça marche.

Écrire un livre en markdown

Sympa comme soft.

j'aime beaucoup la syntax markdown, elle permet d'écrire simplement des documents avec chapitres, puces, gras, ... mais en texte pur et lisible.
Si on respecte la syntaxe il existe ensuite de nombreux outils permettant de convertir le texte en pdf, html, doc, ...
Et c'est nettement plus lisible à versionner dans git ou svn.

Pour voir le rendu markdown de mes docs github avant de les commiter, et éviter ainsi de faire de multiple commits de corrections j'utilise grip :
$ grip mondoc.md

• Running on http://localhost:5000/

Il suffit ensuite d'ouvrir son butineur web préféré pour voir le rendu

d'autres technique pour avoir un rendu «à la github» mais sans conversion pdf.

$ sudo apt-get install python-pip

Pour avoir les tableaux, la seule méthode qui marche c'est d'utiliser grip. puis d'ouvrir son navigateur avec le port correspondant sur localhost.

La syntaxe markdown est fantastique, elle permet de faire des textes lisible en texte pur, mais le texte est tout de même convertible en pdf, html, ... avec des tableau, titre, ...

Voici une petite explication pour faire une conversion en PDF.
Cette syntaxe est reconnue de base dans github par exemple, il faut que le fichier ait l'extension *.md.

Note sur debian il faut aussi installer les paquets suivant :
$ sudo apt-get install ruby-libxml
$ sudo apt-get install libxslt1.1 libxslt1-dev

Et il faut être sudo pour faire l'install de gimli :
$ sudo gem install gimli
$ gimli -f README.md

Mais le rendu de mes tableaux ne marche pas :(