O que Conversor Markdown para LaTeX (md2tex) faz?
Converta manuscritos acadêmicos em Markdown para arquivos LaTeX .tex adequados para submissão a periódicos. Lida com todo o pipeline de conversão: cabeçalhos, negrito/itálico, tabelas pipe, imagens, matemática inline/display, listas com marcadores, caracteres Unicode especiais e formatação de citações.
Início Rápido
# Simples: converte um único .md para artigo classe article
python3 scripts/md2tex.py paper.md -o output/
# Escolher predefinição de classe de documento
python3 scripts/md2tex.py paper.md -o output/ --class ieeetran
python3 scripts/md2tex.py paper.md -o output/ --class revtex
# Multi-arquivo: manuscrito principal + apêndice como material suplementar
python3 scripts/md2tex.py main.md --appendix appendix.md -o output/ --class revtex
# Substituições de preâmbulo personalizadas (adicionar pacotes, comandos, etc.)
python3 scripts/md2tex.py paper.md --preamble my_preamble.tex -o output/
# Compilar PDFs após a geração
python3 scripts/md2tex.py paper.md -o output/ --compile
Os caminhos acima são relativos ao diretório base desta skill.
O Que Ela Faz
O script lê Markdown e produz LaTeX aplicando estas conversões:
| Markdown | LaTeX |
|---|---|
## Seção | \section{Seção} |
### Subseção | \subsection{Subseção} |
#### Subsubseção | \subsubsection{Subsubseção} |
**negrito** | \textbf{negrito} |
*itálico* | \textit{itálico} (ciente de matemática: ignora $...$) |
$$...$$ | $$...$$ (passagem direta) |
$...$ | $...$ (passagem direta) |
| ... | tabelas pipe | \begin{tabular}...\end{tabular} |
 | \begin{figure}\includegraphics...\caption...\end{figure} |
| `![[caminho | alt]]` (Obsidian) |
- marcador | \begin{itemize}\item...\end{itemize} |
α, β, ∞, →, × etc. | $\alpha$, $\beta$, $\infty$, $\to$, $\times$ |
--- (travessão) | --- (preservado) |
Processamento Adicional
- Legendas de imagens: Procura linhas
**Fig. N | ...**ou**Fig. N.**após imagens para construir\caption{...}adequado. - Legendas de tabelas: Procura blocos
**Tabela N | ...**ou**TABELA N**precedendo tabelas pipe. - Matemática Unicode: Mapeia
α β γ ε λ μ π ρ σ ω Γ Λ Σ Ω ∞ → ← × ± ≤ ≥ ≈ ≠ ¬para equivalentes LaTeX. - Caracteres acentuados: Mapeia
é è ê ñ ö ü â î ôpara escapes LaTeX. - Aspas inteligentes:
"" ''para`` ''. łpolonês:Białynicki→Bia{\\l}ynickipara renderização correta.- Limpeza de linhas em branco: Colapsa 4+ linhas em branco para 2.
- Remoção de blockquote: Opcionalmente remove linhas
> ....
Predefinições de Classe de Documento
| Predefinição | Classe de Documento | Caso de Uso |
|---|---|---|
article (padrão) | \documentclass[12pt]{article} | Artigos gerais, arXiv |
revtex | \documentclass[aps,pra,preprint]{revtex4-2} | Periódicos Physical Review |
ieeetran | \documentclass[journal,onecolumn,12pt]{IEEEtran} | Transações IEEE |
Cada predefinição inclui pacotes apropriados (graphicx, amsmath, amssymb, hyperref, booktabs, array).
Preâmbulo Personalizado
Crie um arquivo .tex contendo seu preâmbulo completo (pacotes, comandos, etc.) e passe-o com --preamble. O padrão para cada predefinição é substituído.
Exemplo 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}}}
Tratamento de Citações
Dois modos, definidos com --cite:
bibtex (padrão)
Mantém chaves BibTeX no texto: \cite{key2020}. Por padrão, lê as chaves de citação de uma seção de referências ou arquivo de bibliografia. Quaisquer placeholders de citação no estilo [N] são mantidos como estão, a menos que --cite-map seja fornecido.
inline
Insere \begin{thebibliography}...\end{thebibliography} com entradas escritas manualmente. Use com --biblio references.tex para fornecer o conteúdo da bibliografia.
Opções Avançadas
--title "Título do Artigo" Substituir título do documento (padrão: primeiro cabeçalho #)
--author "Nome" Nome do autor
--affiliation "Univ" Afiliação do autor
--email "[email protected]" Email de correspondência
--abstract Extrair resumo da seção ## Resumo (padrão: automático)
--no-abstract Pular extração de resumo
--appendix appendix.md Converter apêndice como material suplementar
--suppress-numbers Usar \section*{} (sem numeração, para material suplementar)
--cite-map map.json Mapeamento JSON de placeholders de citação para chaves BibTeX
--compile Executar pdflatex duas vezes após a geração
--fig-dir figures/ Diretório para copiar figuras (padrão: detecção automática)
--help Mostrar uso completo
Dicas de Compilação
Após gerar os arquivos .tex, compile com:
# REVTeX (requer revtex4-2.cls instalado)
cd output/ && pdflatex main.tex && pdflatex main.tex
# IEEEtran (requer IEEEtran.cls instalado)
cd output/ && pdflatex main.tex && pdflatex main.tex
O script detecta automaticamente as figuras referenciadas no markdown e as copia do diretório de origem para o diretório de saída.
Limitações
- Não é um conversor de uso geral: Projetado para estrutura de artigo acadêmico (IMRaD + suplementar). Listas aninhadas complexas, blocos de código e notas de rodapé podem precisar de ajuste manual.
- Apenas tabelas pipe: Tags HTML
<table>não são convertidas. - Marcadores de nível único: Atualmente lida com aninhamento de 2 níveis; listas mais profundas podem ser achatadas.
- Ambientes matemáticos:
\begin{aligned}...\end{aligned}etc. passam inalterados — certifique-se de que são LaTeX válido. - Conversão de citações:
[N]para\cite{}requer um arquivo de mapeamento fornecido pelo usuário ou pós-processamento manual. - Sem recarga automática: Regere o
.texapós cada edição do.md; a skill não monitora arquivos.
Para renderização de PDF no estilo Obsidian (A4, Arial, MathJax), use a skill obsidian-pdf.