Communitygithub.com

zhangys11/agent-skills

AI 程式碼代理人的可重複使用技能 (SKILL.md)。包含 obsidian-pdf:Markdown -> Obsidian 風格的 PDF (pandoc + headless Chromium)。

agent-skills 是什麼?

這個技能專門將學術 Markdown 稿件轉換為 LaTeX `.tex` 檔案,適用於期刊投稿。它完整處理從 Markdown 到 LaTeX 的轉換管路:包括標題、粗體/斜體、表格、圖片、顯示/行內數學、項目清單、Unicode 特殊字符以及引用格式。支援多種文件類別預設 (article、revtex、ieeetran),並允許自訂前導碼。主要用於 Claude Code、Cursor 等 AI 編碼代理,可透過 CLI 一鍵轉換單一或多個 Markdown 檔案,並可選擇編譯為 PDF。

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

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

預覽

來自技能 README

替代文字

說明文件

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}
**粗體**\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 技能。

相關技能