Communitygithub.com

Convertisseur Markdown vers LaTeX (md2tex)

Convertit des manuscrits Markdown académiques en fichiers LaTeX .tex prêts pour la soumission à une revue.

Qu'est-ce que Convertisseur Markdown vers LaTeX (md2tex) ?

Cette compétence permet de transformer des manuscrits rédigés en Markdown en fichiers LaTeX complets, adaptés aux contraintes de soumission académique. Elle prend en charge l'ensemble du pipeline de conversion : en-têtes, gras/italique, tableaux en tuyaux, images, formules mathématiques, listes, caractères Unicode spéciaux et formatage des citations. L'outil propose plusieurs préréglages de classe de document (article, revtex, ieeetran) et gère les documents multi-fichiers avec annexe. Elle est utile aux chercheurs et rédacteurs techniques utilisant des environnements comme Claude Code, Cursor ou Codex, qui souhaitent automatiser la préparation de leurs soumissions. Le script détecte intelligemment les légendes d'images et de tableaux, et nettoie les espaces blancs superflus pour produire un LaTeX propre et bien structuré.

Compatible avec✓Claude Code~Codex CLI~Cursor
npx skills add zhangys11/agent-skills

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Aperçu

Depuis le README du skill

alt

Documentation

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 :

MarkdownLaTeX
## 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}
![alt](chemin)\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}ynicki pour 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églageClasse de documentCas 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 .tex aprè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.

Skills associés