変換用途別 `pandoc` コマンド早見表

---

# 📄 Pandoc 変換用途別 コマンド早見表（Wordファイル編）

| 変換内容                                      | Docker 使用コマンド                                                                                         | ローカル環境でのコマンド                                                     | 備考                            |
| ----------------------------------------- | ----------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------- | ----------------------------- |
| **Word → Markdown（標準）**                   | `docker run --rm -v ${PWD}:/data pandoc/core sample.docx -o sample.md`                                | `pandoc sample.docx -o sample.md`                                | 一般的なMarkdownに変換（CommonMark形式） |
| **Word → GitHub Flavored Markdown (GFM)** | `docker run --rm -v ${PWD}:/data pandoc/core sample.docx -t gfm -o sample.md`                         | `pandoc sample.docx -t gfm -o sample.md`                         | テーブルやチェックボックスもGitHub表示に対応     |
| **Word → Markdown（YAMLメタ情報付き）**           | `docker run --rm -v ${PWD}:/data pandoc/core sample.docx -s -o sample.md`                             | `pandoc sample.docx -s -o sample.md`                             | `-s`は standalone（YAMLヘッダ含む）   |
| **Word → DocBook XML**                    | `docker run --rm -v ${PWD}:/data pandoc/core sample.docx -t docbook -o sample.xml`                    | `pandoc sample.docx -t docbook -o sample.xml`                    | セクション構造などをXMLで確認可能            |
| **Word → Pandocネイティブ形式**                  | `docker run --rm -v ${PWD}:/data pandoc/core sample.docx -t native -o sample.native`                  | `pandoc sample.docx -t native -o sample.native`                  | デバッグ用途。pandoc内部構造の確認用         |
| **Word → HTML**                           | `docker run --rm -v ${PWD}:/data pandoc/core sample.docx -o sample.html`                              | `pandoc sample.docx -o sample.html`                              | シンプルなHTML出力（CSSは含まれない）        |
| **Word → PDF（※LaTeX込みイメージが必要）**           | `docker run --rm -v ${PWD}:/data pandoc/latex sample.docx -o sample.pdf`                              | `pandoc sample.docx -o sample.pdf`                               | LaTeX経由でPDFを出力（`core`では不可）    |
| **複数Wordファイル一括変換（Markdown）**              | `bash for f in *.docx; do docker run --rm -v ${PWD}:/data pandoc/core "$f" -o "${f%.docx}.md"; done ` | `bash for f in *.docx; do pandoc "$f" -o "${f%.docx}.md"; done ` | バッチ処理にも対応可能                   |                 |

## オプション
| オプション                 | 意味                                         |
| --------------------- | ------------------------------------------ |
| `-t` / `--to=`        | 出力フォーマット指定（例：`markdown`, `gfm`, `docbook`） |
| `-s` / `--standalone` | ヘッダやYAMLメタ情報を含む完全な文書                       |
| `-o`                  | 出力ファイル名                                    |
| `--extract-media=DIR` | Word内画像を取り出してDIRに保存（Markdownに相対リンク）        |


## 📦 補足：Docker イメージ選び

| イメージ名          | 内容                    | 目的                          |
| -------------- | --------------------- | --------------------------- |
| `pandoc/core`  | 軽量版、LaTeXなし           | Markdown, HTML, XML 変換などに最適 |
| `pandoc/latex` | LaTeX環境付き（TeX Live込み） | PDF出力やLaTeX中間生成が必要な場合       |