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} |
**粗體** | \textbf{粗體} |
*斜體* | \textit{斜體} (數學感知:跳過 $...$) |
$$...$$ | $$...$$ (直通) |
$...$ | $...$ (直通) |
| ... | 管線表格 | \begin{tabular}...\end{tabular} |
 | \begin{figure}\includegraphics...\caption...\end{figure} |
| `![[路徑 | 替代文字]]` (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} | Physical Review 期刊 |
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 "論文標題" 覆寫文件標題 (預設:第一個 # 標題)
--author "作者姓名" 作者姓名
--affiliation "大學" 作者所屬機構
--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>標籤。 - 單層項目:目前處理兩層巢狀;更深層的清單可能會被扁平化。
- 數學環境:
\begin{aligned}...\end{aligned}等保持原樣 — 請確保它們是有效的 LaTeX。 - 引用轉換:
[N]轉換為\cite{}需要使用者提供的映射檔案或手動後處理。 - 無即時更新:每次編輯
.md後需重新產生.tex;此技能不會監控檔案。
如需 Obsidian 風格的 PDF 渲染 (A4, Arial, MathJax),請改用 obsidian-pdf 技能。