Pandoc Word から Markdown: コマンドライン変換ガイド

Pandocは,最も強力な文書変換ツールです. .docx を Markdown に変換し,出力に対する精細なコントロールを提供します. このガイドは,あなたが使用する必要がありますすべてのカバー Pandoc for Word to Markdown について 変換する

パンドックとは何か?

Pandocは,フォーマット間のドキュメントを変換する無料,オープンソースのコマンドラインツールです. 40以上の入力・出力フォーマットをサポートしている. Word から Markdown への変換では, Pandoc はゴールドスタンダードである. ブラウザベースのツールよりも設定が可能です. WordToMD.

Pandoc と対していつ使うか WordToMD:

スケジュール	Pandoc	WordToMD
単一の変換	インストールが必要	✅ 瞬時に,ブラウザをベースに
バッチ変換	✅ スクリプト	一件ずつ
カスタム出力フォーマット	✅ 幅広い選択肢	標準 GFMのみ
プライバシーに敏感なドキュメント	✅ 地元での処理	✅ ブラウザのみ,アップロードなし
終末期経験がない	CLI の知識が必要	✅ 引いて下ろす
CI/CD パイプライン	✅ 自動化できる	自動化できない

Pandoc をインストール

ウィンドウ

インストーラをダウンロードする pandoc.org/インストール.htmlパッケージマネージャーを使用してください.

# Winget
winget install pandoc

# Chocolatey
choco install pandoc

# Scoop
scoop install pandoc

マコス

# Homebrew
brew install pandoc

# MacPorts
sudo port install pandoc

Linux について

# Ubuntu/Debian
sudo apt-get install pandoc

# Fedora
sudo dnf install pandoc

# Arch
sudo pacman -S pandoc

設置を確認する:

pandoc --version

基本変換コマンド

pandoc document.docx -o output.md

それだ Pandoc から入力形式を推論する .docx そして, .md.

もっと明確なバージョン:

pandoc -f docx -t markdown document.docx -o output.md

出力フォーマットオプション

Pandoc は複数の Markdown バリアントを出力として提供します.

# GitHub Flavored Markdown (GFM)
pandoc document.docx -t gfm -o output.md

# CommonMark
pandoc document.docx -t commonmark -o output.md

# Pandoc's extended Markdown (most features)
pandoc document.docx -t markdown -o output.md

# Standard Markdown (basic)
pandoc document.docx -t markdown_strict -o output.md

GFM が推奨される ほとんどの用例 (GitHub, Obsidian, GitBook, Notion) についてです.

便利な変換選択肢

メディアファイルを抽出する

.docx に埋め込まれた画像は,ディレクトリに抽出されます:

pandoc document.docx --extract-media=./media -o output.md

画像を保存します. ./media/ そして Markdown 画像参照を出力に追加します

包装ライン

制御ラインの外出に包み込み:

# No wrapping (one paragraph = one line)
pandoc document.docx --wrap=none -o output.md

# Wrap at 80 characters
pandoc document.docx --wrap=auto --columns=80 -o output.md

--wrap=none バージョン制御される Markdown のために推奨されますよりクリーンな Git diffs を生成します.

内容表

pandoc document.docx --toc -o output.md

メタデータを含む独立文書

pandoc document.docx -s -o output.md

について -s (standalone) flag は,ドキュメントのメタデータからYAMLフロントマターを生成します.

バッチ変換

ディレクトリ内の .docx ファイルをすべて変換する:

Windows パワーシェル

Get-ChildItem -Filter "*.docx" | ForEach-Object {
    $output = [System.IO.Path]::ChangeExtension($_.Name, ".md")
    pandoc $_.FullName -t gfm --wrap=none -o $output
    Write-Host "Converted: $($_.Name) → $output"
}

バッシュ (macOS/Linux)

for file in *.docx; do
    output="${file%.docx}.md"
    pandoc "$file" -t gfm --wrap=none -o "$output"
    echo "Converted: $file → $output"
done

バッチ変換の選択肢については, バッチ変換 Word に Markdown.

Lua フィルターで出力をカスタマイズする

Pandoc は,変換中に文書 AST を変換する Lua フィルターをサポートします:

pandoc document.docx --lua-filter=my-filter.lua -o output.md

例 Lua フィルターでカスタムなフロントマターブロックを追加する:

-- add-frontmatter.lua
function Meta(meta)
  meta.draft = false
  meta.author = "WordToMD Team"
  return meta
end

これはブラウザツールに匹敵できないカスタマイズです

Pandocとマモット.jsの比喩

WordToMD マモット.jsを機内用しています. Pandocは独自の解析器を使用します. 主要な違い

特徴	Pandoc	マンモット.js (WordToMD)
画像抽出	✅ `--extract-media`	️ 変換ノートに記載されている
カスタマイズされたスタイル	✅ 参照経由 doc	️ 警告としてログイン
数学方程式	✅MathML → LaTeX	サポートされていません
トラック変更	✅ 設定可能	剥がれ
脚注	✅ 保存された	️ インラインのみ
コメント	✅ オプション	剥がれ

複雑なドキュメントでは Pandoc がより完全な出力を提供します. 簡単な文書では WordToMD はゼロセットアップでより速く動作します.

Pandoc デフォルトファイル

同じ設定で繰り返し変換するには,デフォルトファイルを作成します.

# my-defaults.yaml
from: docx
to: gfm
wrap: none
extract-media: ./media
standalone: true

実行する

pandoc document.docx -d my-defaults.yaml -o output.md

CI/CD で Pandoc を使用する

自動化パイプライン (GitHubアクションなど) に対して:

# .github/workflows/convert-docs.yml
- name: Install Pandoc
  run: sudo apt-get install pandoc

- name: Convert Word docs to Markdown
  run: |
    for f in docs/*.docx; do
      pandoc "$f" -t gfm --wrap=none -o "${f%.docx}.md"
    done

FAQ

Pandoc出力 \ 私のマークダウンでラインの継続. どうやって除去する? 追加する --wrap=none 硬線包装を無効にします

私のテーブルは Pandoc出力で混乱しているようです. やってみろ -t gfm GFM 表の構文は Pandoc Markdown 表のデフォルトではなく

画像は出力に表示されません. 追加する --extract-media=./images 埋め込み画像を抽出するターゲット環境で正しく参照してください

Pandocはスマート引用を " 文字文字文字文字文字文字文字文字文字文字文字文字文字文字文字文字文字文字文字文字文字文字文字文字文字文字文字文字追加する --no-highlight テンプレートを変更する. 特にスマートコートでは,ほとんどの出力フォーマットでデフォルトで保存する必要があります.

Pandoc と WordToMD は DOCX と Markdown とどのように比較されますか? 両方とも標準文書に適しています WordToMDはゼロセットアップを必要とし,クリーンな GFM出力を生成します. Pandocはインストールが必要ですが,複雑な文書 (画像,数学,コメント,足記) をより完全に処理します.

結論

Pandocは,最も優れたツールです WordからMarkdown 変換,特にバッチ処理,カスタム出力フォーマット,およびCI/CDパイプライン. 装置を設置することなく迅速かつ一度に変換する WordToMD 仕事を即座に完了させるこの2つの道具は互いをよく補完します.