Markdown
Pandoc
Word
Docker

MarkdownをWordのテンプレートを充てつつdockerのpandocでWordに変換する

設計書を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

Screen Shot 2019-04-10 at 16.43.30.png

以前いた職場で設計書やマニュアルをMarkdownからpandocを利用してWordやPDFに変換していた際は、

ローカルのPCに環境を構築するのが大変だった記憶があるが、dockerだとすぐ出来て楽。

Wordのテンプレートのレイアウトと、Markdownのタグを上手く脳内マッピングすればいい感じに出来そうだけど、

良い感じの変換結果にしたい場合、Wordのレイアウトを作成する知識がある程度必要そう。


参考