設計書をMarkdownにしてGitで管理出来ないかという話が出てきたので、
環境構築及びMarkdownファイルにテンプレートを充てるまで実施してみる。
確認環境
- Mac OS Mojave 10.14.3
前提
- dockerがインストールされていること。
手順
サンプル用のMarkdownファイルを取得。
$ curl https://raw.githubusercontent.com/mitsuaki1229/Sample/master/Documents/ForPandockConversionFile/ForPandockConversionFile.md -o ForPandockConversionFile.md
変換時にレイアウトとして充てる無料のテンプレートを拝借し、解凍。
$ curl http://siland.jp/data/manual.zip -o manual.zip
$ docker run --rm -v `pwd`:/data ca54makske/ubuntu-unzip -Ocp932 ./manual.zip
拝借したテンプレートを充てつつMarkdownファイルからWordファイルを生成。
$ docker run -v `pwd`:/source jagregory/pandoc -f markdown -t docx README.md -o README.docx --reference-doc='業務マニュアル（テンプレート）/グリーン.docx'
結果
$ open README.docx
以前いた職場で設計書やマニュアルをMarkdownからpandocを利用してWordやPDFに変換していた際は、
ローカルのPCに環境を構築するのが大変だった記憶があるが、dockerだとすぐ出来て楽。
Wordのテンプレートのレイアウトと、Markdownのタグを上手く脳内マッピングすればいい感じに出来そうだけど、
良い感じの変換結果にしたい場合、Wordのレイアウトを作成する知識がある程度必要そう。