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 :

• Site officiel
• Le format Markdown
• La syntaxe
• Test en ligne
• Exemples

Lire :

• Présentation du format Markdown
• Markdown avec VSCode

Exemple

Exemple de fichier au format Markdown :

Remarque : pour préciser des métadonnées (titre, auteur et date), il est préférable d’utiliser la syntaxe suivante :

---
title: Un titre
author: un auteur <<tvaira@free.fr>>
date: 18/06/2015
---

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) :

• Pandoc et Package Pandoc msi

Avec interface graphique (GUI) pour pandoc :

• PanConvert et Package PanConvert msi

Plugin Word pour pandoc :

• Writage et Package Writge msi

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 :