Communitygithub.com

Conversor Markdown para LaTeX (md2tex)

Converte manuscritos acadêmicos em Markdown para arquivos LaTeX (.tex) prontos para submissão a periódicos. Lida com cabeçalhos, negrito/itálico, tabelas pipe, imagens, matemática, listas e formatação de citações.

O que é Conversor Markdown para LaTeX (md2tex)?

Esta skill converte manuscritos acadêmicos em Markdown para arquivos LaTeX (.tex) adequados para submissão a periódicos, oferecendo um pipeline completo de conversão. Ela lida com cabeçalhos, negrito/itálico, tabelas pipe, imagens, matemática inline/display, listas com marcadores, caracteres Unicode especiais e formatação de citações. A skill suporta predefinições de classe de documento como 'article', 'revtex' (para Physical Review) e 'ieeetran' (para transações IEEE), cada uma incluindo pacotes apropriados. Também permite preâmbulos personalizados, modo apêndice, compilação opcional de PDF e conversão de citações nos modos BibTeX ou inline. Útil para pesquisadores que escrevem em Markdown e precisam gerar LaTeX para submissão, a skill mantém a estrutura de documento acadêmico (IMRaD + suplementar) e oferece processamento adicional como mapeamento Unicode para LaTeX, conversão de aspas inteligentes e captura de legendas de imagens/tabelas.

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add zhangys11/agent-skills

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Prévia

Do README da skill

alt

Documentação

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:

MarkdownLaTeX
## 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}
![alt](caminho)\begin{figure}\includegraphics...\caption...\end{figure}
`![[caminhoalt]]` (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}ynicki para 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çãoClasse de DocumentoCaso 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 .tex apó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.

Habilidades Relacionadas