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,执行以下转换:
| Markdown | LaTeX |
|---|---|
## Section | \section{Section} |
### Subsection | \subsection{Subsection} |
#### Subsubsection | \subsubsection{Subsubsection} |
**bold** | \textbf{bold} |
*italic* | \textit{italic}(数学感知:跳过 $...$) |
$$...$$ | $$...$$(透传) |
$...$ | $...$(透传) |
| ... | 管道表格 | \begin{tabular}...\end{tabular} |
 | \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 技能。