Le format Markdown

Présentation

Markdown est un langage de balisage léger créé par John Gruber en 2004. Son but est d’offrir une syntaxe facile à lire et à écrire.

Un document formaté selon Markdown devrait pouvoir être publié comme tel, en texte, sans donner l’impression qu’il a été marqué par des balises ou des instructions de formatage.

Un document rédigé en Markdown peut être converti facilement en HTML, PDF, ODT, EPUB etc …

Quelques liens :

Exemple

Exemple de fichier au format Markdown :

Après conversion en HTML :

Pandoc sous Linux

Sous Linux, vous pouvez utiliser l’outil pandoc pour convertir un fichier au format Markdown dans de nombreux autres formats (HTML, PDF, ODT, EPUB etc … ). L’éditeur Geany propose un module de prévisualisation intégré.

Quelques conversions avec pandoc :

# format odt
$ pandoc --toc -o exemple.odt exemple.md

# format pdf
$ pandoc --toc -o exemple.pdf exemple.md

# format html
$ pandoc -s -S --toc -o exemple.html exemple.md
// avec une feuille de style externe
$ pandoc -s -S --toc -c exemple.css -A signature.html -o exemple.html exemple.md
        
# format epub
$ pandoc -S exemple.md -o exemple.epub

Pandoc sous Windows

En ligne de commande (CLI) :

Avec interface graphique (GUI) pour pandoc :

Plugin Word pour pandoc :

Tests :

  • Pandoc :

Installer pandoc-1.17.0.2-windows.msi

Lancer cmd.exe puis pandoc :

Voir les options de pandoc :

C:\Users\Thierry\Documents\markdown-windows>pandoc -h

Editer un document .md puis le convertir en HTML :

C:\Users\Thierry\Documents\markdown-windows>pandoc -s -S --toc -o markdown-windows.html markdown-windows.md

Et le convertir en .odt :

C:\Users\Thierry\Documents\markdown-windows>pandoc --toc -o markdown-windows.odt markdown-windows.md
  • PanConvert :

Installer PanConvert-0.1.5-win32.msi

Lancer Panconvert.exe

Edit -> Préferences pour configurer le chemin ver pandoc :

Ouvrir un fichier ou saisir un texte puis le convertir :

  • Writage :

Installer Writage-1.8.3.msi

Lancer Word et ouvrir un document markdown :