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) | 同上 |
- 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 スキルを使用してください。