docs-latex

Markdown から LaTeX への変換

Markdown ドキュメントを、高度な組版、TikZ/PGFPlots による可視化、PDF コンパイルを活用して、プロ品質の LaTeX に変換します。

このスキルを使用する場面

次のような場合にこのスキルを使用します...	次のような場合は別のスキルを使用します...
Markdown をプレゼンテーション品質の PDF に変換する	Markdown ドキュメントを作成する（/docs:generate）
図や可視化を含むレポートを作成する	簡単なテキストの書式設定をする
印刷可能な戦略文書を作成する	HTML ドキュメントを作成する
チャートやタイムラインを含むライフサイクルレポートを作成する	既存のドキュメントを同期する（/docs:sync）

コンテキスト

• 現在のディレクトリ：!pwd
• 利用可能な .md ファイル：!find . -maxdepth 2 -name '*.md' -not -name 'CHANGELOG.md' -not -name 'README.md'

パラメーター

• <file>：Markdown ソースファイルのパス（必須）
• --no-compile：.tex ファイルのみを生成し、PDF のコンパイルをスキップします
• --visualizations：TikZ/PGFPlots の図（タイムライン、チャート、リスクマトリクス）を含めます
• --report-type：ドキュメント構成のプリセット
  • roadmap：タイムラインの可視化を含むフェーズベースのロードマップ
  • lifecycle：リリースチャートとベロシティグラフを含むプロジェクトライフサイクル
  • general：標準的なプロ品質のドキュメント（デフォルト）

実行

次の Markdown から LaTeX への変換ワークフローを実行します。

ステップ 1：Markdown ソースを分析する

ソースの Markdown ファイルを読み込み、次の内容を抽出します。

• ドキュメントのタイトルとメタデータ
• セクション階層（# のレベルを LaTeX の章／セクションに対応付けます）
• 表、リスト、コードブロック、コールアウトブロック、引用ブロック
• 色分けマーカーに使用する優先度またはステータスのインジケーター
• 可視化に適した数値データ

ステップ 2：LaTeX ドキュメントを生成する

ソースと同じディレクトリに .tex ファイルを作成します。REFERENCE.md にあるドキュメントのプリアンブル、色の定義、カスタム環境、変換ルールを使用します。

Markdown から LaTeX への変換ルールを適用します。

Markdown	LaTeX
# Title	\chapter{Title}
## Section	\section{Section}
### Subsection	\subsection{Subsection}
**bold**	\textbf{bold}
*italic*	\textit{italic}
`code`	\texttt{code}
- item	\begin{itemize}\item ...\end{itemize}
1. item	\begin{enumerate}\item ...\end{enumerate}
> quote	\begin{tcolorbox}...\end{tcolorbox}
[text](url)	\href{url}{text}
表	\toprule、\midrule、\bottomrule を使った booktabs の表
コードブロック	\begin{lstlisting}...\end{lstlisting}
- [ ] / - [x]	$\square$ / $\boxtimes$（amssymb が必要）

ステップ 3：可視化を追加する（--visualizations が指定されている場合、またはデータから必要と判断される場合）

ドキュメントの内容に基づいて、適切な TikZ/PGFPlots の可視化を選びます。REFERENCE.md の可視化テンプレートを使用します。

• タイムライン：フェーズを含むロードマップ向け
• 棒グラフ／円グラフ：リリースまたは指標データ向け
• リスクマトリクス：リスク／影響データを含むドキュメント向け
• テストピラミッド：QA／テスト関連のドキュメント向け

ステップ 4：PDF にコンパイルする

1. 利用できない場合は LaTeX ツールチェーンをインストールします。

   apt-get update && apt-get install -y texlive-latex-extra texlive-fonts-recommended \
     texlive-fonts-extra texlive-science latexmk
   

2. 相互参照を解決するため、2 回コンパイルします。

   pdflatex -interaction=nonstopmode DOCUMENT.tex
   pdflatex -interaction=nonstopmode DOCUMENT.tex
   

3. コンパイルに失敗した場合は、一般的なコンパイルの修正方法について REFERENCE.md を確認します。

ステップ 5：リポジトリの生成物を整理する

まだ追加されていない場合は、LaTeX のビルド生成物を .gitignore に追加します：*.aux、*.log、*.out、*.toc、*.lof、*.lot、*.fls、*.fdb_latexmk、*.synctex.gz、*.bbl、*.blg、*.nav、*.snm、*.vrb。

後処理

1. 出力された PDF のパス、ページ数、ファイルサイズを報告します
2. 生成した可視化の内容を要約します
3. 対応が必要な可能性のあるコンパイル警告を一覧表示します
4. まだ追加されていない場合は、.gitignore への追加項目を提案します

エージェント向けの最適化

コンテキスト	コマンド
LaTeX のインストールを確認	which pdflatex 2>/dev/null
クイックコンパイル	pdflatex -interaction=nonstopmode -halt-on-error FILE.tex
フルコンパイル（目次を含む）	pdflatex -interaction=nonstopmode FILE.tex && pdflatex -interaction=nonstopmode FILE.tex
PDF のページ数を確認	pdfinfo FILE.pdf 2>/dev/null
PDF のファイルサイズを確認	stat -f %z FILE.pdf 2>/dev/null
ツールチェーンをインストール	apt-get install -y texlive-latex-extra texlive-fonts-recommended texlive-fonts-extra texlive-science
エラーのみ	pdflatex -interaction=nonstopmode FILE.tex 2>&1

LaTeX のパターン、TikZ テンプレート、パッケージのリファレンスについて詳しくは、REFERENCE.md をご覧ください。