15
18

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

More than 5 years have passed since last update.

Wordフォーマット指定の報告書をMarkdownで書けるようにしたので備忘メモ

Last updated at Posted at 2016-07-22

私は普段のメモは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ファイルも数か所程度は手を入れないと見た目がイマイチなのですが,それでも以前より所要時間はずっと少なくなったので,とりあえず大分満足です.

4. 参考

Pandocの使い方
Pandocが扱えるMarkdown

15
18
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
15
18

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?