技術記録

Pandoc で Markdown から 業務文書.docx を作るテンプレート1

概要

業務文書を Markdown で書き，Pandoc によって Word ファイルとして出力する方法をご紹介します。Markdown では文書の内容や構造（これは見出し・これは強調といった抽象的な指示）のみを扱い，文書の見映えは Pandoc に任せることができます2。これによって，Word 文書を作るときにありがちなお節介によるストレスも避けられます。

Markdown はテキストエディタによってテキストファイルとして書けるため，Microsoft Word の将来の価格・存続にかかわらず内容を残すことができ，安心です。

背景

私は教員です。 職場においては，業務にかかる文書は Microsoft Word で作ることが当たり前となっています。 しかし，Microsoft Word でを使って文章を書くとき，重さ・お節介・保守性などの面が気になります。

前提

  • Pandoc の導入が済んでいる。
  • Markdown の記法を知っている。

内容

仕様

Markdown で書いたものを Pandoc で Word 形式にするためのテンプレートファイルとバッチファイルです。おおむねこのような出力になります。また，外部用文書のためにもう少し厳格な体裁で出力するテンプレートファイルも同梱しています。

  • BIZ UD フォントを既定としています。
  • 強調は日本語らしくなりません。Word で開くと，スタイルの欄に _em というスタイルがあります。これを使ってください。
  • 箇条書きは無理をして，compact スタイルを書き換えることで作っています。もとの compact スタイルを使いたいときは，代わりに _originalcompact スタイルを選んでください。また，箇条書きのネストもうまく働きません。手で整えてください。

フォントのライセンス

既定としている BIZ UD フォントは SIL Open Font License 1.13 で公開されています。ですから，できあがったものを web にアップロードするにあたってもフォントの心配はありません。

BIZ UD フォントの解説・お持ちでない場合のダウンロード方法についてはこちらの記事をお勧めします4。

ダウンロード

特に理由がなければ，上にある新しいものをお使いください。

参考

導入と基本的な使用に関すること

知見

  1. 改訂　2023-08-12。「Pandoc で Markdown から 業務文書.docx を作る」からタイトルを変更。内容を明瞭にした。 ↩︎

  2. 追記　2023-08-13。 ↩︎

  3. たぬき侍，「SILオープンフォントライセンス」って何？という方のためのざっくり解説。たぬきフォント，参照 2022-07-29。 ↩︎

  4. コリス，フォントが大好物な人に朗報 MORISAWA BIZ UDゴシックとUD明朝がオープンソースになったぞ！！。coliss.com，参照 2022-07-29。 ↩︎

  5. 石橋秀仁，日本語Markdownユーザー会。日本語Markdownユーザー会，参照 2022-07-29。 ↩︎

  6. 藤原惟，日本Pandocユーザ会。日本Pandocユーザ会，参照 2022-07-29。 ↩︎

  7. John MacFarlane，Pandoc a universal document converter。pandoc.org，参照 2022-07-29。 ↩︎

  8. niszet，Pandocの情報収集、どうする？。niszetの日記，参照 2022-07-29。 ↩︎

  9. 須藤正彬，Pandocを用いた論文のフォーマット変換。須通り Sudo Masaaki official site，参照 2022-07-29。 ↩︎

  10. 藤原惟，Pandocテンプレート：デフォルトのやつを使うべきか否か。Zenn，参照 2022-07-29。 ↩︎

  11. mk_55，PandocでTemplateを使うときのためのメモ。mk_55’s diary，参照 2022-07-29。 ↩︎

  12. zr_tex8r，日本語Markdown文書をPandocする際に「余計な空白」をどうにかしたい。Qiita，参照 2022-07-29。 ↩︎

  13. zr_tex8r，「箇条書きを含む段落」をMarkdownするとアレ。Qiita，参照 2022-07-29。 ↩︎

  14. ロボ太，Markdownからdocxを作る。Qiita，参照 2022-07-29。 ↩︎