pandoc-converter

Pandoc コンバーター

Pandoc を使用して、一般的な形式間でドキュメントを変換します。

クイックスタート

# Basic conversion (format auto-detected from extensions)
python scripts/convert.py input.md output.docx

# Specify output format only
python scripts/convert.py document.md --to html

# Check if Pandoc is installed
python scripts/convert.py --check

# List supported formats
python scripts/convert.py --formats

対応形式

ドキュメント形式（読み込み／書き込み）： markdown、html、docx、latex、epub、rtf、pptx、pdf
データ形式（読み取り専用）： csv、tsv、xlsx
Markdown のバリアント： gfm（GitHub）、commonmark

対応状況の詳細は、references/format-compatibility.md を参照してください。

よく使われる変換

変換元	変換先	コマンド
Markdown	Word	python scripts/convert.py doc.md doc.docx
Markdown	PDF	python scripts/convert.py doc.md doc.pdf
Markdown	HTML	python scripts/convert.py doc.md doc.html
Word	Markdown	python scripts/convert.py doc.docx doc.md
CSV	HTML テーブル	python scripts/convert.py data.csv data.html
LaTeX	PDF	python scripts/convert.py paper.tex paper.pdf

オプション

オプション	説明
--from <fmt>	入力形式の自動判定を上書きします
--to <fmt>	出力ファイルを指定しない場合に、出力形式を指定します
--standalone	ドキュメントのヘッダー／フッターを含めます
--toc	目次を追加します
--pdf-engine <eng>	PDF エンジン：pdflatex、xelatex、lualatex

その他の Pandoc オプションは、そのまま渡されます。

ワークフロー

1. インストールを確認する： python scripts/convert.py --check を実行します
2. インストールされていない場合： 表示されるインストール手順に従います
3. 変換する： 入力ファイルと出力ファイルを指定して変換を実行します
4. 結果を提示する： 変換後のファイルをユーザーに提供します

インストール（必要な場合）

スクリプトにインストール手順が表示されますが、概要は次のとおりです。

# macOS
brew install pandoc

# Ubuntu/Debian  
sudo apt-get install pandoc

# For PDF output, also install LaTeX:
# macOS: brew install --cask mactex-no-gui
# Ubuntu: sudo apt-get install texlive-xetex

制限事項

• CSV/TSV/XLSX： 入力専用です（他の形式ではテーブルに変換されます）
• PDF 出力： LaTeX のインストールが必要です
• PPTX： テキスト抽出には対応していますが、複雑なレイアウトは簡略化される場合があります
• 複雑な書式： 形式間で一部の機能が引き継がれない場合があります