Conversor de Markdown a LaTeX (md2tex)
Convierte manuscritos académicos en Markdown a archivos LaTeX .tex adecuados para el envío a revistas. Maneja el pipeline completo de conversión: encabezados, negrita/cursiva, tablas tipo pipe, imágenes, matemáticas en línea y en display, listas con viñetas, caracteres Unicode especiales y formato de citas.
Inicio rápido
# Simple: convierte un solo .md a .tex con clase article
python3 scripts/md2tex.py paper.md -o output/
# Elegir una clase de documento predefinida
python3 scripts/md2tex.py paper.md -o output/ --class ieeetran
python3 scripts/md2tex.py paper.md -o output/ --class revtex
# Múltiples archivos: manuscrito principal + apéndice como material suplementario
python3 scripts/md2tex.py main.md --appendix appendix.md -o output/ --class revtex
# Sobrescribir preámbulo personalizado (añadir paquetes, comandos, etc.)
python3 scripts/md2tex.py paper.md --preamble my_preamble.tex -o output/
# Compilar PDFs después de la generación
python3 scripts/md2tex.py paper.md -o output/ --compile
Las rutas anteriores son relativas al directorio base de esta habilidad.
Qué hace
El script lee Markdown y produce LaTeX aplicando estas conversiones:
| Markdown | LaTeX |
|---|---|
## Sección | \section{Sección} |
### Subsección | \subsection{Subsección} |
#### Subsubsección | \subsubsection{Subsubsección} |
**negrita** | \textbf{negrita} |
*cursiva* | \textit{cursiva} (consciente de matemáticas: omite $...$) |
$$...$$ | $$...$$ (paso directo) |
$...$ | $...$ (paso directo) |
| ... | tablas pipe | \begin{tabular}...\end{tabular} |
 | \begin{figure}\includegraphics...\caption...\end{figure} |
![[ruta|alt]] (Obsidian) | Igual que arriba |
- viñeta | \begin{itemize}\item...\end{itemize} |
α, β, ∞, →, × etc. | $\alpha$, $\beta$, $\infty$, $\to$, $\times$ |
--- (raya) | --- (preservado) |
Procesamiento adicional
- Pies de imagen: Busca líneas
**Fig. N | ...**o**Fig. N.**después de las imágenes para construir el\caption{...}adecuado. - Pies de tabla: Busca bloques
**Tabla N | ...**o**TABLA N**que preceden a las tablas pipe. - Matemáticas Unicode: Mapea
α β γ ε λ μ π ρ σ ω Γ Λ Σ Ω ∞ → ← × ± ≤ ≥ ≈ ≠ ¬a sus equivalentes LaTeX. - Caracteres acentuados: Mapea
é è ê ñ ö ü â î ôa escapes LaTeX. - Comillas inteligentes:
"" ''a`` ''. łpolaco:Białynicki→Bia{\\l}ynickipara una representación correcta.- Limpieza de líneas en blanco: Reduce 4+ líneas en blanco a 2.
- Eliminación de citas en bloque: Opcionalmente elimina líneas
> ....
Clases de documento predefinidas
| Predefinida | Clase de documento | Caso de uso |
|---|---|---|
article (por defecto) | \documentclass[12pt]{article} | Artículos generales, arXiv |
revtex | \documentclass[aps,pra,preprint]{revtex4-2} | Revistas Physical Review |
ieeetran | \documentclass[journal,onecolumn,12pt]{IEEEtran} | Transacciones IEEE |
Cada predefinida incluye paquetes apropiados (graphicx, amsmath, amssymb, hyperref, booktabs, array).
Preámbulo personalizado
Crea un archivo .tex que contenga tu preámbulo completo (paquetes, comandos, etc.) y pásalo con --preamble. La predefinida para cada clase se sobrescribe.
Ejemplo my_preamble.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}}}
Manejo de citas
Dos modos, se establecen con --cite:
bibtex (por defecto)
Mantiene las claves BibTeX en el texto: \cite{key2020}. Por defecto lee las claves de cita de una sección de referencias o archivo de bibliografía. Los marcadores de cita estilo [N] se dejan como están a menos que se proporcione --cite-map.
inline
Incrusta \begin{thebibliography}...\end{thebibliography} con entradas escritas a mano. Usa --biblio references.tex para proporcionar el contenido de la bibliografía.
Opciones avanzadas
--title "Título del artículo" Sobrescribe el título del documento (por defecto: primer encabezado #)
--author "Nombre" Nombre del autor
--affiliation "Universidad" Afiliación del autor
--email "[email protected]" Correo electrónico de correspondencia
--abstract Extraer resumen de la sección ## Resumen (por defecto: automático)
--no-abstract Omitir extracción de resumen
--appendix apéndice.md Convertir apéndice como material suplementario
--suppress-numbers Usar \section*{} (sin numeración, para material suplementario)
--cite-map mapa.json Mapeo JSON de marcadores de cita a claves BibTeX
--compile Ejecutar pdflatex dos veces después de la generación
--fig-dir figuras/ Directorio del que copiar figuras (por defecto: detección automática)
--help Mostrar uso completo
Sugerencias de compilación
Después de generar los archivos .tex, compila con:
# REVTeX (requiere revtex4-2.cls instalado)
cd output/ && pdflatex main.tex && pdflatex main.tex
# IEEEtran (requiere IEEEtran.cls instalado)
cd output/ && pdflatex main.tex && pdflatex main.tex
El script detecta automáticamente las figuras referenciadas en el markdown y las copia del directorio fuente al directorio de salida.
Limitaciones
- No es un convertidor de propósito general: Diseñado para la estructura de artículos académicos (IMRaD + material suplementario). Las listas anidadas complejas, los bloques de código y las notas al pie pueden requerir ajustes manuales.
- Solo tablas pipe: Las etiquetas HTML
<table>no se convierten. - Viñetas de un solo nivel: Actualmente maneja anidación de 2 niveles; las listas más profundas pueden aplanarse.
- Entornos matemáticos:
\begin{aligned}...\end{aligned}etc. pasan sin cambios; asegúrate de que son LaTeX válido. - Conversión de citas:
[N]a\cite{}requiere un archivo de mapeo proporcionado por el usuario o un posprocesamiento manual. - Sin recarga en vivo: Regenera
.texdespués de cada edición de.md; la habilidad no vigila archivos.
Para renderizado PDF estilo Obsidian (A4, Arial, MathJax), usa la habilidad obsidian-pdf.