【Pandoc】マークダウンをdocxファイルに変換する方法

今月のおもな作業が仕様書を作成なのだが、
SharePoint に置かれた Word ファイルをみんなで編集しましょうという
なかなかの苦行だった
そもそも、Word の使い勝手が悪すぎる

世間には マークダウン で書いて docx ファイルを出力する Pandoc なるものがあるらしいので、
少し触って、使えそうならこちらで書いていきたい

今回はWindows環境で触ってみたので
コマンドもコマンドプロンプトでのコマンドを記載する

公式サイト

https://pandoc.org/

PAndoc について

ファイルを異なる形式のファイルに変換してくれる
何に変換できるかは、公式の Top に記載されている

PAndoc のダウンロード

こちらから OS に合わせてダウンロード
また、Window 環境でChocolateyがあるのならば、

choco install pandoc

mac で HomeBrew があるなら、

 brew install pando

で入れるよう

(cmd で入れる場合は管理者権限で実行する必要があった)

pandoc -v

でバージョン情報がでれば OK

pandoc.exe 2.17.1.1

ファイル変換

test ように以下のように書かれたpandocTest.mdファイルを作成

# TEST1

## TEST2

### TEST3

TEST

ファイルがあるディレクトリで以下を実行

pandocTest.md -o pandocTest.docx

成功すると同じディレクトリにpandocTest.docxできる

出力したdocxファイル

書式の変更

デフォルトの Word 書式を変更

テンプレートの変更

出力時のフォーマットを変更するときは テンプレートを出力して、フォーマットの修正
修正したテンプレートを出力時に参照してあげるようにする

テンプレートの出力

pandoc -o custom-reference.docx --print-default-data-file reference.docx

修正したテンプレートを参照させる

pandoc pandocTest.md --reference-doc=custom-reference.docx -o result.docx

.md形式で保存できるので、Git管理と相性がよさそうな感触
また、設定ファイルを.ymlで持てるみたいなので、

複数人での編集も楽になりそうな雰囲気
マークダウンでGit管理して、最終納品物をPandocで出力する方法に切り替えるかな