Que fait Convertisseur Markdown vers LaTeX (md2tex) ?
Convertit des manuscrits Markdown académiques en fichiers LaTeX .tex prêts pour la soumission à une revue. Gère l'ensemble du pipeline de conversion : en-têtes, gras/italique, tableaux en tuyaux, images, mathématiques en ligne et affichées, listes à puces, caractères Unicode spéciaux et formatage des citations.
Prise en main rapide
# Simple : convertir un seul .md en classe article .tex
python3 scripts/md2tex.py article.md -o sortie/
# Choisir un préréglage de classe de document
python3 scripts/md2tex.py article.md -o sortie/ --class ieeetran
python3 scripts/md2tex.py article.md -o sortie/ --class revtex
# Multi-fichier : manuscrit principal + annexe en supplément
python3 scripts/md2tex.py principal.md --appendix annexe.md -o sortie/ --class revtex
# Surcharge personnalisée du préambule (ajouter des packages, commandes, etc.)
python3 scripts/md2tex.py article.md --preamble mon_preambule.tex -o sortie/
# Compiler les PDF après génération
python3 scripts/md2tex.py article.md -o sortie/ --compile
Les chemins ci-dessus sont relatifs au répertoire de base de cette compétence.
Ce qu'il fait
Le script lit le Markdown et produit du LaTeX en appliquant ces conversions :
| Markdown | LaTeX |
|---|---|
## Section | \section{Section} |
### Sous-section | \subsection{Sous-section} |
#### Sous-sous-section | \subsubsection{Sous-sous-section} |
**gras** | \textbf{gras} |
*italique* | \textit{italique} (conscient des maths : ignore $...$) |
$$...$$ | $$...$$ (transparent) |
$...$ | $...$ (transparent) |
| ... | tableaux en tuyaux | \begin{tabular}...\end{tabular} |
 | \begin{figure}\includegraphics...\caption...\end{figure} |
![[chemin|alt]] (Obsidian) | Identique à ci-dessus |
- puce | \begin{itemize}\item...\end{itemize} |
α, β, ∞, →, × etc. | $\alpha$, $\beta$, $\infty$, $\to$, $\times$ |
--- (tiret cadratin) | --- (conservé) |
Traitement supplémentaire
- Légendes d'images : recherche vers l'avant des lignes
**Fig. N | ...**ou**Fig. N.**après les images pour construire\caption{...}. - Légendes de tableaux : recherche des blocs
**Tableau N | ...**ou**TABLEAU N**précédant les tableaux en tuyaux. - Mathématiques Unicode : mappe
α β γ ε λ μ π ρ σ ω Γ Λ Σ Ω ∞ → ← × ± ≤ ≥ ≈ ≠ ¬vers leurs équivalents LaTeX. - Caractères accentués : mappe
é è ê ñ ö ü â î ôvers les échappements LaTeX. - Guillemets intelligents :
"" ''vers\` '' `. łpolonais :Białynicki→Bia{\l}ynickipour un rendu correct.- Nettoyage des lignes vides : réduit 4+ lignes vides à 2.
- Suppression des citations : supprime optionnellement les lignes
> ....
Préréglages de classe de document
| Préréglage | Classe de document | Cas d'utilisation |
|---|---|---|
article (par défaut) | \documentclass[12pt]{article} | Articles généraux, arXiv |
revtex | \documentclass[aps,pra,preprint]{revtex4-2} | Revues Physical Review |
ieeetran | \documentclass[journal,onecolumn,12pt]{IEEEtran} | Transactions IEEE |
Chaque préréglage inclut les packages appropriés (graphicx, amsmath, amssymb, hyperref, booktabs, array).
Préambule personnalisé
Créez un fichier .tex contenant votre préambule complet (packages, commandes, etc.) et passez-le avec --preamble. La valeur par défaut de chaque préréglage est alors remplacée.
Exemple mon_preambule.tex :
\documentclass[aps,pra,reprint]{revtex4-2}
\usepackage{graphicx}
\usepackage{amsmath,amssymb}
\usepackage{hyperref}
\usepackage{booktabs}
\usepackage{xcolor}
\newcommand{\pbox}[2]{\parbox{#1}{\vspace{4pt}\RaggedRight #2\vspace{4pt}}}
Gestion des citations
Deux modes, définis avec --cite :
bibtex (par défaut)
Conserve les clés BibTeX dans le texte : \cite{cle2020}. Par défaut, lit les clés de citation à partir d'une section références ou d'un fichier de bibliographie. Les espaces réservés de citation au format [N] sont laissés tels quels, sauf si --cite-map est fourni.
inline
Intègre \begin{thebibliography}...\end{thebibliography} avec des entrées manuscrites. Utilisez avec --biblio references.tex pour fournir le contenu de la bibliographie.
Options avancées
--title "Titre de l'article" Remplacer le titre du document (par défaut : premier titre #)
--author "Nom" Nom de l'auteur
--affiliation "Univ" Affiliation de l'auteur
--email "[email protected]" Email correspondant
--abstract Extraire le résumé de la section ## Résumé (par défaut : auto)
--no-abstract Ignorer l'extraction du résumé
--appendix annexe.md Convertir l'annexe en matériel supplémentaire
--suppress-numbers Utiliser \section*{} (non numéroté, pour matériel supplémentaire)
--cite-map map.json Mapping JSON des espaces réservés de citation vers les clés BibTeX
--compile Exécuter pdflatex deux fois après génération
--fig-dir figures/ Répertoire depuis lequel copier les figures (par défaut : détection auto)
--help Afficher l'utilisation complète
Conseils de compilation
Après avoir généré les fichiers .tex, compilez avec :
# REVTeX (nécessite revtex4-2.cls installé)
cd sortie/ && pdflatex principal.tex && pdflatex principal.tex
# IEEEtran (nécessite IEEEtran.cls installé)
cd sortie/ && pdflatex principal.tex && pdflatex principal.tex
Le script détecte automatiquement les figures référencées dans le markdown et les copie du répertoire source vers le répertoire de sortie.
Limitations
- Pas un convertisseur universel : conçu pour la structure des articles académiques (IMRaD + supplément). Les listes imbriquées complexes, les blocs de code et les notes de bas de page peuvent nécessiter un ajustement manuel.
- Tableaux en tuyaux uniquement : les balises
<table>HTML ne sont pas converties. - Puces à un seul niveau : gère actuellement 2 niveaux d'imbrication ; les listes plus profondes peuvent être aplaties.
- Environnements mathématiques :
\begin{aligned}...\end{aligned}etc. sont transmis tels quels — assurez-vous qu'ils sont valides en LaTeX. - Conversion des citations :
[N]vers\cite{}nécessite un fichier de mapping fourni par l'utilisateur ou un post-traitement manuel. - Pas de rechargement en direct : régénérez le
.texaprès chaque modification du.md; la compétence ne surveille pas les fichiers.
Pour un rendu PDF au style Obsidian (A4, Arial, MathJax), utilisez plutôt la compétence obsidian-pdf.