私は普段のメモはMarkdown形式で取ることが多いのですが,場合によってはWord等でフォーマットが指定されている場合があるかと思います.
Wordは文書のフォーマット合わせに非常に時間がかかってしまって苦痛だったので,Pandocというツールを使って.mdファイルを.docxファイルに変換することにしました.
変換時にテンプレートのWordファイルを指定することにより,指定のフォーマットにもほぼほぼ合わせることができます.
1. 環境構築
1-1. Pandocインストーラのダウンロード
Githubから,Pandocの最新の安定版リリースのインストーラをダウンロード.
Macならpkg, Windowsならmsiのインストーラがあります.
1-2. Pandocのインストール
ダウンロードしたインストーラを実行,インストール.
環境変数 Path に 「C:\Users\UserName\AppData\Local\Pandoc」(※UserName はユーザ名)が登録されているか確認する.
もしなければ追加してパスを通す.
1-3. テンプレートのWordファイルの作成
指定されているフォーマット通りの見た目になるように,Wordテンプレートを作る.形式は普通のdocxでOK.
Pandocが扱えるWordのスタイルは限られているので,そのスタイルを使って目的のフォーマットが実現できるようにテンプレートのWordファイルを作る.
Pandocが扱えるWordのスタイルは,Pandocの特定のWriterに影響を与えるオプションの--reference-docxオプションを参照.
出来上がったテンプレートのWordファイルを任意の場所に置く.
2. MarkdownファイルをWordに変換
2-1. (Windowsの場合) PowerShellを起動
2-2. Markdownファイルの置いてあるフォルダに移動
cd ~\somedir
2-3. 次のコマンドで.mdファイルを.docxファイルに変換
pandoc <変換するMarkdownファイル> -o 返還後のdocxファイル --reference-docx テンプレートのdocxファイル
例)
pandoc '.\高品質アプリの作り方.md' -o 高品質アプリの作り方.docx --reference-docx .\report_template.docx
3. 所感その他
今回のWordフォーマット固有の問題なのですが,Pandocが変換可能なWordのスタイルと,指定のWord報告書フォーマットとの相性の問題で,Markdownファイルの方はちょっと変わったフォーマットで書いておかないといけません.
そのMarkdownをそのままQiita等に投稿するフローを狙っていたのですが,現状はいったんフォーマットを直す必要があります.
返還後のWordファイルも数か所程度は手を入れないと見た目がイマイチなのですが,それでも以前より所要時間はずっと少なくなったので,とりあえず大分満足です.