Communitygithub.com

Markdown 转 LaTeX 转换器 (md2tex)

将学术 Markdown 稿件转换为适用于期刊投稿的 LaTeX .tex 文件,支持完整的转换管线。

Markdown 转 LaTeX 转换器 (md2tex) 是什么?

该技能专为 AI 编码代理(如 Claude Code、Cursor、Codex)设计,用于将学术 Markdown 稿件自动转换为 LaTeX .tex 文件,适合期刊投稿。它支持完整的转换管线,包括标题、粗体/斜体、管道表格、图片、显示/行内数学公式、项目列表、Unicode 特殊字符以及引用格式。支持多种文档类预设(article、revtex、ieeetran),并允许自定义导言区。用户还可选择编译 PDF、处理附录、提取摘要以及管理引用(BibTeX 或行内参考文献)。该技能并非通用转换器,而是专注于学术论文结构(如 IMRaD 格式和补充材料),但诸如嵌套列表、代码块和脚注等功能可能需要手动调整。

兼容平台✓Claude Code~Codex CLI~Cursor
npx skills add zhangys11/agent-skills

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

预览

来自技能 README

alt

文档

Markdown 转 LaTeX 转换器 (md2tex) 是做什么的?

将学术 Markdown 稿件转换为适用于期刊投稿的 LaTeX .tex 文件。处理完整的转换管线:标题、粗体/斜体、管道表格、图片、显示/行内数学公式、项目列表、Unicode 特殊字符以及引用格式化。

快速开始

# 简单:将单个 .md 转换为 article 类 .tex
python3 scripts/md2tex.py paper.md -o output/

# 选择文档类预设
python3 scripts/md2tex.py paper.md -o output/ --class ieeetran
python3 scripts/md2tex.py paper.md -o output/ --class revtex

# 多文件:主稿件 + 附录作为补充材料
python3 scripts/md2tex.py main.md --appendix appendix.md -o output/ --class revtex

# 自定义导言区覆盖(添加宏包、命令等)
python3 scripts/md2tex.py paper.md --preamble my_preamble.tex -o output/

# 生成后编译 PDF
python3 scripts/md2tex.py paper.md -o output/ --compile

以上路径相对于此技能的基准目录。

功能描述

该脚本读取 Markdown 并生成 LaTeX,执行以下转换:

MarkdownLaTeX
## Section\section{Section}
### Subsection\subsection{Subsection}
#### Subsubsection\subsubsection{Subsubsection}
**bold**\textbf{bold}
*italic*\textit{italic}(数学感知:跳过 $...$)
$$...$$$$...$$(透传)
$...$$...$(透传)
| ... | 管道表格\begin{tabular}...\end{tabular}
![alt](path)\begin{figure}\includegraphics...\caption...\end{figure}
![[path|alt]](Obsidian)同上
- 项目符号\begin{itemize}\item...\end{itemize}
α, β, ∞, →, × 等$\alpha$, $\beta$, $\infty$, $\to$, $\times$
---(长破折号)---(保留)

额外处理

  • 图片标题:在图片后查找 **Fig. N | ...** 或 **Fig. N.** 行,构建正确的 \caption{...}。
  • 表格标题:在管道表格前查找 **Table N | ...** 或 **TABLE N** 块。
  • Unicode 数学:将 α β γ ε λ μ π ρ σ ω Γ Λ Σ Ω ∞ → ← × ± ≤ ≥ ≈ ≠ ¬ 映射为 LaTeX 等效形式。
  • 带重音字符:将 é è ê ñ ö ü â î ô 映射为 LaTeX 转义序列。
  • 智能引号:"" '' 转换为 `` ''。
  • 波兰语 ł:Białynicki → Bia{\l}ynicki 以确保正确渲染。
  • 空行清理:将 4 个以上连续空行压缩为 2 个。
  • 引用块移除:可选择去除 > ... 行。

文档类预设

预设文档类适用场景
article(默认)\documentclass[12pt]{article}通用论文、arXiv
revtex\documentclass[aps,pra,preprint]{revtex4-2}物理评论期刊
ieeetran\documentclass[journal,onecolumn,12pt]{IEEEtran}IEEE 期刊

每个预设都包含适当的宏包(graphicx、amsmath、amssymb、hyperref、booktabs、array)。

自定义导言区

创建一个包含完整导言区(宏包、命令等)的 .tex 文件,并通过 --preamble 传递。这将覆盖每个预设的默认导言区。

示例 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}}}

引用处理

通过 --cite 设置两种模式:

bibtex(默认)

在文本中保留 BibTeX 键:\cite{key2020}。默认从参考文献节或参考文献文件读取引用键。任何 [N] 样式的引用占位符将保持原样,除非提供 --cite-map。

inline

嵌入 \begin{thebibliography}...\end{thebibliography} 并包含手写条目。使用 --biblio references.tex 提供参考文献内容。

高级选项

--title "Paper Title"     覆盖文档标题(默认:第一个 # 标题)
--author "Name"           作者姓名
--affiliation "Univ"      作者单位
--email "[email protected]"      联系邮箱
--abstract                 从 ## Abstract 节提取摘要(默认:自动)
--no-abstract              跳过摘要提取
--appendix-appendix.md     将附录转换为补充材料
--suppress-numbers         使用 \section*{}(无编号,用于补充材料)
--cite-map map.json        JSON 映射,用于将引用占位符转换为 BibTeX 键
--compile                  生成后运行两次 pdflatex
--fig-dir figures/         从中复制图片的目录(默认:自动检测)
--help                     显示完整用法

编译提示

生成 .tex 文件后,使用以下命令编译:

# REVTeX(需要已安装 revtex4-2.cls)
cd output/ && pdflatex main.tex && pdflatex main.tex

# IEEEtran(需要已安装 IEEEtran.cls)
cd output/ && pdflatex main.tex && pdflatex main.tex

脚本会自动检测 Markdown 中引用的图片,并将其从源目录复制到输出目录。

限制

  • 非通用转换器:专为学术论文结构(IMRaD + 补充材料)设计。复杂的嵌套列表、代码块和脚注可能需要手动调整。
  • 仅支持管道表格:HTML <table> 标签不会被转换。
  • 单级列表:当前支持 2 级嵌套;更深层次的列表可能被扁平化。
  • 数学环境:\begin{aligned}...\end{aligned} 等会原样透传——请确保它们是有效的 LaTeX。
  • 引用转换:[N] 到 \cite{} 的转换需要用户提供映射文件或手动后续处理。
  • 无实时重载:每次编辑 .md 后需重新生成 .tex;该技能不监视文件变化。

如需 Obsidian 风格的 PDF 渲染(A4、Arial、MathJax),请使用 obsidian-pdf 技能。

相关技能