L1 Info : Informatique et Document, MarkDown & Pandoc
 
◃  Ch. 2 Pandoc  ▹
 

Formats MarkDown et extensions

  • commonmark

    • format invoqué avec pandoc -f commonmark ... ;
    • Version "standardisée" mais limité : pas de gestion des tableaux, pas de possibilité de définir des attributs HTML.
  • markdown

    • format invoqué avec pandoc -f markdown ... ;
    • gestion des tableaux (code HTML lourd avec usage de l'attribut style pour toutes les cellules !), exemple :
      <td style="text-align: left;">contenu</td>
    • insertion automatique d'un identifiant pour les titres, ainsi le code markdown
      # Titre principal

      devient

      <h1 id="titre-principal">Titre principal</h1>
    • possibilité de définir des classes et des identifiants, exemple :
      # Mon titre avec classe  {.maClasse}
      ## Mon titre avec ID {#monId}
      ### Mon titre avec attribut libre {valign="top"}
      #### Mon titre avec plusieurs attributs {title="bulle" .toto #target}
      ##### Mon titre avec valeurs multiples d'attributs {class="menu align-center"}

      devient

      <h1 class="maClasse" id="mon-titre-avec-classe">Mon titre avec classe</h1>
      <h2 id="monId">Mon titre avec ID</h2>
      <h3 data-valign="top" id="mon-titre-avec-attribut-libre">Mon titre avec attribut libre</h3>
      <h4 class="toto" title="bulle" id="target">Mon titre avec attributs</h4>
      <h5 class="menu align-center" id="mon-titre-avec-valeurs-multiples-dattributs">Mon titre avec valeurs multiples
      d’attributs</h5>
  • markdown_strict (Similaire à commonmark, identique ?)

    • format invoqué avec pandoc -f markdown_strict ... ;
    • pas d'identifiant inséré dans les titres ;
    • pas de gestion des tableaux.
  • Extensions de formats :

    • Pandoc met à disposition des extensions de format qui permettent de mettre en oeuvre des options de traitement :
      • space_in_atx_header extension (utilisée par défaut) qui impose la présence d'un espace après le(s) # introduisant les titres
      • pipe_tables extension qui permet de traiter les tableaux markdown
      • header_attributes extension qui permet de configurer lels attributs des balises ouvrantes des titres (voir plus haut)
      • ...
    • Pour en savoir plus : https://pandoc.org/MANUAL.html#pandocs-markdown
  • Ajout ou suppression d'une extension de format

    • Pour ajouter ou supprimer une option de traitement à un format reconnu par pandoc il suffit de compléter le nom du format avec celui de l'extension
    • Le nom de l'extension sera précédé d'un + pour ajouter l'option
    • Le nom de l'extension sera précédé d'un - pour supprimer l'option
    • Exemple : avec la commande pandoc -f markdown_strict+pipe_tables-space_in_atx_headers ...,
      le traitement des tableaux markdown sera activé et l'espace après le(s) # ne sera plus obligatoire dans les sources traitées