Ce billet est en cours d’écriture, les informations ne sont donc pas encore complètes.
- Introduction
- Prérequis logiciels
- Structure du markdown
- Un éditeur de texte pour SHS : Zettlr
- Les formats d’export
- Du Markdown au Word
- Du Markdown au PDF
- Du Markdown au HTML
- Méthode de recherche, méthode d’écriture
- Présenter ses recherches
- Grapher ses recherches
- Ressources bibliographique
Le YAML est un format simple de représentation de données conçu pour être lisible par des humains, tout en travaillant avec des langages de programmation (c’est presque la quadrature du cercle !). Dans le cadre du Markdown, le langage YAML est avant tout utilisé pour déclarer en en-tête des informations sur le fichier qui ne font pas partie du contenu à proprement parler, c’est-à-dire des métadonnées comme le nom de l’auteur, les mots-clés, ou le titre.

À savoir
Un certains nombres de paramètres d’affichage dépendent des déclarations du YAML. Par exemple, la création d’une bibliographie finale du document, d’une table des matières, mais aussi des éléments de ponctuations selons les normes anglaises ou françaises (citation, guillemets, etc.), il est donc important de compléter le YAML avant l’export. D’autres paramètres vont dépendre de Pandoc1.
La langue
Pour déclarer la langue, il faut utiliser des valeurs de la norme BCP-47. Elle est composée d’une première valeur qui indique la langue et d’une deuxième valeur pour indiquer la région. Les deux valeurs sont séparées par un tiret :
en-US pour l'anglais américain.
En plus d’intervenir au moment de l’export sur la ponctuation, cette variable contrôle la langue des éléments généré automatiquement comme, par exemple, le titre de la bibliographie2.
Quelques exemples de clés de langue
- Allemand : de-DE
- Anglais : en-GB ; en-US ; en-CA
- Français : fr-FR ; fr-CA (Canada) ; fr-CH (Suisse) ; fr-BE (Belgique)
- Espagnol : es-ES ; es-US ; es-MX (Mexique)
- Italien : it-IT ; it-CH
- Néerlandais : nl-BE ; nl-NL
- Chinois : zh-CN ; sh-HK (Hong Kong) ; zh-TW (Taiwan)