---
title: Mise en page des exports à partir de Markdown avec Pandoc
author: Arthur Perret
date: 04/12/2019
lang: fr
link-citations: true
---

## 1. Traitement de texte

On peut générer une copie du modèle docx par défaut avec la commande suivante :

pandoc --print-default-data-file reference.docx > reference.docx

Pandoc utilise les styles suivants, ce sont eux qu'il faut modifier :

- *Paragraph styles*: `Normal`; `Body Text`; `First Paragraph`; `Compact`; `Title`; `Subtitle`; `Author`; `Date`; `Abstract`; `Bibliography`; `Heading 1`; `Heading 2`; `Heading 3`; `Heading 4`; `Heading 5`; `Heading 6`; `Heading 7`; `Heading 8`; `Heading 9`; `Block Text`; `Footnote Text`; `Definition Term`; `Definition`; `Caption`; `Table Caption`; `Image Caption`; `Figure`; `Captioned Figure`; `TOC Heading`.
- *Character styles*: `Default Paragraph Font`; `Body Text Char`; `Verbatim Char`; `Footnote Reference`; `Hyperlink`.
- *Table style*: `Table`.

Une façon pratique de procéder :

1. créez un exemple complet minimal (ECM), c'est-à-dire un fichier Markdown dans lequel vous mettez tous les éléments dont vous pourriez avoir besoin ;
2. convertissez l'ECM en docx avec Pandoc, qui va lui appliquer son modèle par défaut ;
3. modifiez les styles dans le document ainsi créé ;
4. lorsque vous avez fini, effacez tout le contenu du document (les styles sont conservés) et enregistrez-le sous le nom `reference.docx` ;
5. placez ce fichier dans votre [dossier utilisateur Pandoc](https://pandoc.org/MANUAL.html#option--data-dir) pour qu'il soit utilisé à la place du modèle par défaut.

## 2. HTML/CSS

Testez et customisez [cette feuille de style](https://gist.github.com/killercup/5917178) ou bien [celle-ci](https://github.com/otsaloma/markdown-css/blob/master/github.css).

Exemple pour les références bibliographiques :

.references p {
	text-indent: -20px;
	margin-left: 20px;
}
:target {
	animation: highlight 3s ease;  
}
@keyframes highlight {
	0% { background-color: #ffa; }
	100% { background-color: transparent; }
}

## 3. PDF

La documentation de Zettlr contient [un guide à la fabrication de modèles LaTeX](https://docs.zettlr.com/en/academic/custom-templates/). De façon plus générale, vous pouvez également consulter [le livre de Maïeul Rouquette](http://geekographie.maieul.net/95) [-@rouquette2012].

> « La typographie est simple, aussi simple que de jouer du violon ! » Maximilien Vox, typographe [cité dans @rouquette2012, 189].

## Au-delà de Markdown

Quelques liens utiles pour aller plus loin dans l'écosystème du balisage léger en texte brut.

Syntaxes : [Markdown](https://commonmark.org/), [reStructuredText](https://fr.wikipedia.org/wiki/ReStructuredText), [Asciidoc](http://asciidoc.org/)

Générateurs :

- Documentation : [Mkdocs](https://www.mkdocs.org/), [Sphinx](http://www.sphinx-doc.org/en/master/#), [Antora](https://antora.org/)
- Blogs : [Jekyll](http://jekyllrb.com/), [Hugo](https://gohugo.io/)
- Édition : [Bookdown](https://bookdown.org/), [Quire](https://gettypubs.github.io/quire/), [Abrüpt](https://gohugo.io/)

Hébergeurs : [Read the Docs](https://readthedocs.org/), [GitLab Pages](https://docs.gitlab.com/ee/user/project/pages/), [Netlify](https://www.netlify.com/)

## Bibliographie