Du Markdown au PDF en utilisant LaTeX ? Dans le monde de l’écriture scientifique et pédagogique, LaTeX reste une référence incontournable pour produire des documents de qualité professionnelle. Mais sa syntaxe parfois complexe, son manque de souplesse pour les rédactions rapides, et sa relative lourdeur peuvent freiner les utilisateurs occasionnels ou ceux qui souhaitent simplement rédiger vite et bien.
C’est là qu’intervient Markdown, un langage de balisage léger, conçu pour être lisible en brut, rapide à écrire, et facilement convertible dans une multitude de formats, du HTML au PDF. Combiné à des outils comme Pandoc, il devient un pont élégant entre simplicité et puissance, permettant d’intégrer des formules LaTeX tout en conservant une syntaxe épurée.
Cet article propose de découvrir comment utiliser Markdown comme point d’entrée, et LaTeX comme moteur de rendu final. L’objectif ? Mettre en place un flux de travail moderne qui permet de rédiger des notes de cours, des fiches, ou des articles en toute fluidité, sans sacrifier la qualité typographique.
Du Markdown au PDF avec LaTeX: qu’est-ce que le Markdown ?
Markdown est un langage de balisage léger inventé en 2004 par John Gruber, avec l’aide d’Aaron Swartz. Son objectif est simple : permettre à tout le monde d’écrire du texte structuré (titres, listes, liens, emphase, etc.) dans un format lisible sans traitement.
Contrairement à LaTeX, HTML ou XML, qui sont puissants mais verbeux, Markdown privilégie la simplicité. Il est pensé pour qu’un document brut puisse être lu sans interprétation spéciale. Par exemple :
# C'est un titre
Voici un paragraphe avec du **gras**, de l'*italique* et du `code`.
## Une liste :
- Premier élément
- Deuxième élément
Ce code produit un document structuré, qui pourra ensuite être converti automatiquement vers :
- HTML (page web),
- PDF (via LaTeX),
- DOCX, EPUB, etc.
Markdown ne cherche pas à tout faire, mais plutôt à faire bien les choses simples : structurer un texte, hiérarchiser les idées, inclure des liens, du code, des citations, etc.
Pourquoi les développeurs, enseignants et chercheurs l’adorent ?
- Il est ultra léger : un simple fichier
.md
suffit. - Il s’écrit dans n’importe quel éditeur de texte.
- Il est versionnable facilement avec Git (Git détecte très facilement les changements dans un fichier .md).
- Il est facile à apprendre : 15 minutes suffisent pour 90 % des usages.
De plus, avec des outils comme Pandoc, Typora, Zettlr ou Obsidian, Markdown devient un véritable environnement d’écriture, compatible avec les équations, les figures, les citations bibliographiques… et donc parfaitement adapté à un usage mathématique ou pédagogique.
Du Markdown au PDF avec LaTeX: intégrer des mathématiques dans Markdown
L’un des grands atouts de Markdown, surtout pour un usage scientifique ou pédagogique, est sa capacité à intégrer des formules mathématiques en LaTeX, de manière très naturelle.
Cette fonctionnalité n’est pas standard dans le Markdown « de base », mais elle est largement supportée par des outils comme Pandoc, Typora, Obsidian, ou les moteurs de rendu web comme MathJax ou KaTeX.
Équations en ligne et équations centrées
On peut insérer des formules mathématiques avec la syntaxe LaTeX habituelle :
- En ligne : entre simples
$...$
- En bloc (centré) : entre doubles
$$...$$
On peut donc continuer à écrire les équations comme en \(\LaTeX\), tout en profitant de la simplicité du Markdown pour le reste du texte.
L'équation $E = mc^2$ est bien connue. Si l'on veut isoler $c$, cela donne:$$c = \sqrt{\frac{E}{m}}.$$
Astuce : écrire comme en LaTeX, mais plus vite
Markdown ne cherche pas à remplacer LaTeX, mais à en simplifier l’usage :
- vous écrivez les maths comme d’habitude,
- cela vous épargne la gestion des
\section
, des marges, des paquets, etc. - on peut générer un PDF typographié avec LaTeX si l’on passe par un moteur comme Pandoc.
C’est l’idéal pour rédiger :
- des fiches de cours,
- des notes personnelles,
- des exercices avec solutions,
- ou même des articles de blog comme celui-ci.
Par exemple : si vous tenez un blog pédagogique (comme mathweb.fr), vous pouvez rédiger des articles en Markdown avec des formules LaTeX intégrées, puis :
- les publier tels quels (si ton site les supporte),
- ou les convertir en HTML avec MathJax,
- ou encore les transformer en PDF bien mis en page pour impression ou diffusion.
Cela permet de conserver une seule version source (le .md
) et de la diffuser facilement sous plusieurs formats (HTML, PDF, etc.), avec une mise en page élégante.
Transformer un fichier Markdown en PDF avec Pandoc
Une fois le fichier Markdown rédigé, on peut le convertir automatiquement en PDF en s’appuyant sur un outil puissant : Pandoc. Ce logiciel open source agit comme un traducteur universel de formats de documents, et peut transformer un simple .md
en .pdf
, .html
, .docx
, et bien d’autres.
Installation rapide de Pandoc
Linux
sudo apt install pandoc
macOS (via Homebrew)
brew install pandoc
Windows
Il faut aller sur la page https://pandoc.org/installing.html.
Pour produire un PDF, Pandoc s’appuie sur un moteur LaTeX installé sur ton système. Si vous n’avez pas encore LaTeX, installez par exemple TeX Live (Linux), MacTeX (Mac), ou MiKTeX (Windows).
Exemple minimal : conversion en PDF
Imaginons un fichier cours.md
:
# Dérivées et fonctions
Soit $f(x) = x^3 + 2x$. Alors :
$$
f'(x) = 3x^2 + 2
$$
Pour le convertir en PDF via la ligne de commande :
pandoc cours.md -o cours.pdf
Et c’est tout !
Le PDF produit aura une belle mise en page par défaut, avec les formules mathématiques correctement rendues grâce au moteur \(\LaTeX\) en arrière-plan.
Personnaliser la mise en page avec un template
Pandoc peut utiliser un modèle LaTeX personnalisé, si vous voulez un style plus typé « fiche de cours », « article scientifique », ou même « beamer » pour des présentations. Par exemple :
pandoc cours.md -o cours.pdf --template mon-template.tex
On peut aussi :
- ajouter une table des matières :
--toc
- choisir une police ou une taille de texte :
-V fontsize=12pt
- changer la classe \(\LaTeX\) utilisée :
-V documentclass=article
oureport
, etc.
Aller plus loin : vers un vrai flux de travail Markdown + LaTeX
Une fois qu’on a vu comment convertir un fichier .md
en .pdf
, on peut aller plus loin et mettre en place un flux de travail fluide et reproductible, qui combine :
- la rapidité de rédaction du Markdown,
- la puissance de rendu du moteur LaTeX,
- et la flexibilité de Pandoc.
C’est particulièrement utile si on rédige régulièrement :
- des fiches de cours,
- des exercices avec solutions,
- des supports de révision pour les élèves,
- ou même des articles structurés, comme celui-ci.
Créer un squelette réutilisable
On peut créer un modèle de document Markdown avec une structure prête à l’emploi :
% Nom du cours
% Ton nom
% \today
# Titre principal
## Objectifs
- …
## Partie 1 : notions
### Définition
$$
\text{Si } f(x) = x^2, \text{ alors } f'(x) = 2x
$$
## Partie 2 : exercices
1. Calculer la dérivée de $f(x) = \sin x$
Personnaliser un template LaTeX Pandoc
On peut ensuite créer un template .tex
qui donne à tous tes PDF un style cohérent (ex : marges, titre en haut, numérotation des sections, couleurs, etc.). Un exemple de début de template personnalisé :
\documentclass[11pt]{article} \usepackage{amsmath, amssymb} \usepackage{geometry} \geometry{margin=2.5cm} \usepackage{fancyhdr} \pagestyle{fancy} \fancyhead[L]{\textsc{Mathweb.fr}} \fancyhead[R]{\today}
Lancer la conversion automatiquement
Avec un simple script make.sh
(ou make.bat
sur Windows), on peut automatiser la compilation :
#!/bin/bash pandoc cours.md -o cours.pdf --template=template.tex --toc -V fontsize=12pt
Un double-clic, et hop : ton fichier .md
devient un beau PDF, sans effort.
Bonus : intégration avec Git + GitHub
On peut aussi :
- versionner le contenu avec Git,
- stocker les notes dans un dépôt GitHub ou GitLab (public ou privé),
- et même automatiser la génération de PDF avec GitHub Actions !
Conclusion
Dans un monde où l’on jongle de plus en plus entre formats, outils et supports de publication, Markdown s’impose comme un formidable levier de simplicité. Couplé à \(\LaTeX\) via Pandoc, il devient un outil de travail à la fois léger, puissant et polyvalent, capable de produire rapidement des documents de qualité professionnelle, qu’il s’agisse d’articles, de cours, ou de supports pédagogiques.
En adoptant ce flux de travail moderne — Markdown pour la rédaction, Pandoc pour la conversion, LaTeX pour le rendu — on gagne en efficacité sans sacrifier la rigueur ni la typographie. C’est une solution idéale pour tous ceux et toutes celles qui souhaitent écrire des documents mathématiques de manière fluide, propre et reproductible.
Si vous n’avez jamais essayé Markdown, c’est peut-être le moment de vous y mettre. Et si vous utilisez déjà \(LaTeX\), il se pourrait bien que Markdown devienne votre nouvel allié du quotidien.