Introduction

• Markdown est un langage de balisage simple
  • facile à lire et écrire par les humains et les programmes
  • qui permet de transformer un fichier balisé vers HTML ou PDF automatiquement
  • dont il existe plusieurs variantes
• Pandoc est un logiciel de conversion de documents
  • il permet de convertir des fichiers d’un format de balisage à un autre

Markdown

Syntaxe générale

La syntaxe de Markdown permet

• de donner une structure au document

  • paragraphes : séparation par des lignes vides
  • titres de différents niveaux : lignes débutant par des #
  • listes libres : indentation de paragraphe avec lignes débutant par des - ou des *
  • listes ordonnées : indentation avec lignes débutant par des 1.
  • blocs de citations : paragraphes préfixés par “>”
  • blocs de codes : paragraphes indentés par 4 espaces

• d’inclure des éléments de mise en forme logique

  emphase, accentuation forte et code

• d’inclure des liens vers des URL

  • https://daringfireball.net/projects/markdown
  • CommonMark
  • Markdown à la sauce GitLab
  • Markdown à la sauce Github

Elle est décrite en détails ailleurs (cf liens de cette diapo)

Images

![Texte alternatif pour HTML](https://www.lifl.fr/~beaufils/logos/logo-markdown.png){ width=50% }

Tableaux

• Plusieurs supports de tableaux accessibles via le Markdown de pandoc
• Celui utilisé par Gitlab et GitHub est très basique
  • défini par pipe_tables dans pandoc

Code source

Le code source peut être coloré en fonction de la syntaxe du language

#include <stdio.h>
int main(int argc, char ** argv) {
    printf("Hello world !\n");
}

pandoc

• Pandoc est un logiciel de conversion de documents
  • il permet de convertir des fichiers d’un format de balisage à un autre
  • il définit une extension de Markdown : Pandoc’s Markdown
• Options importantes
  • -f : format du fichier de départ
  • -t : format du fichier de sortie
  • -o : nom du fichier de sortie
• Plus de détails
  • man pandoc