Communitygithub.com

md2tex:Markdown から LaTeX 変換スキル

学術用 Markdown 原稿をジャーナル投稿に対応した LaTeX .tex ファイルに変換します。ヘッダー、太字/斜体、表、画像、数式、引用など、完全な変換パイプラインを備えています。

md2tex:Markdown から LaTeX 変換スキル とは?

このスキルは、学術論文執筆のための Markdown 原稿を、各ジャーナルの投稿形式に合った LaTeX ファイルに変換するツールです。arXiv や Physical Review、IEEE Transactions など、主要な論文投稿先に対応したドキュメントクラスのプリセット(article、revtex、ieeetran)を用意しており、ユーザーは簡単なコマンドでクラスを指定できます。変換パイプラインは、見出し、太字/斜体、パイプ表、画像、インライン/ディスプレイ数式、箇条書き、Unicode 特殊文字、引用フォーマットをカバー。さらに、画像キャプションの自動生成、Unicode 数式記号の LaTeX へのマッピング、アクセント文字のエスケープ、スマート引用符の変換など、細かな処理も自動で行います。複数ファイルの処理(本稿 + 付録)やカスタムプリアンブルの指定、生成後の PDF コンパイルにも対応。Claude Code や Codex などの AI エージェントから利用でき、学術論文執筆のワークフローを効率化します。

対応✓Claude Code~Codex CLI~Cursor
npx skills add zhangys11/agent-skills

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

プレビュー

スキル 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)同上
- bullet\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 で 2 つのモードを設定します:

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       引用プレースホルダーから BibTeX キーへの JSON マッピング
--compile                 生成後に pdflatex を 2 回実行
--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 スキルを使用してください。

関連スキル