Gitで管理しているドキュメントはWordやExcelで書くよりも、Markdownで書いた方が保守しやすく、更新が楽になります。
しかし、Markdownで作成するとGitLabなどのMarkdownをレンダリングしてくれるサイトから見るには良くても、外部配布向けにプリント機能でPDFにすると、今ひとつWordで作った方が見栄えがよくなるなぁと感じています。
そこで、Marked2というアプリを使ったPDFの作成方法を紹介します。
Marked2とは?
Marked2はMac用のアプリでMarkdownのビューワアプリです。Mac App Storeから購入するか、SETAPPのサブスク経由で利用可能です。私はSETAPPのサブスク経由で使用しています。

Markdownをある程度、スタイル良くレンダリングしようと思うと、VSCodeにプラグインを入れて、GitHubスタイルのCSSを入れるという方法もあるのですが、けっこう手間がかかります。手間をかかるけど、最初だけなので、それでも良いと思っていたのですが、何度もやっていると面倒になり、私はMarked2を使うようになりました。
Marked2は有償だけあって、最初からGitHubスタイルのレンダリングを選択することができ、PDF以外にもHTMLやdocx形式の出力も可能です。この記事ではPDFにしますが、docxに出力して、Wordで仕上げても良いでしょう。
Marked2の設定
Marked
メニューのPreferences
から色々設定できます。私のお勧め設定は以下の通りです。
Styleタブ
Style
タブは、Default style:
をGitHub
に変更します。MarkdownがGitHubと同じスタイルでレンダリングされます。

Exportタブ
Print background colors and images
, Use first H1 as fallback title
, Indicate page breaks in preview
をオンにします。
Indicate page breaks in preview
をオンにすると、プレビュー上でページ区切りが分かるので、必要に応じて、ページ区切りを追加します。
Headers and Footers
のTop Left
に%title
、 Bottom Right
に%page/%total
を設定し、Include on first page
のHeader
とFooter
をオンにします。
PDF化したときに、ヘッダーにドキュメントタイトル、フッターにページ番号が挿入されます。

PDFの作成
PDFを作成するには、File
メニューからExport As
-> Save PDF (Paginated)
を選択します。
Tips
Markedを使ってPDFを作るときのちょっとしたTipsを紹介します。
特定の場所でページを区切りたい
Markdownの中で、次のように書くと、そこで改ページが行われます。
<!--BREAK-->
目次を入れたい
PDFのしおりにはなってくれないのですが、ハイパーリンク付きの目次ページを生成できます。Markdownの中で次のように書いた場所に目次が生成されます。
<!--TOC-->
Preferences
ウインドウのExport
タブのPrint table of contents
オプションはオフで使用します。Print table of contents
オプションだと、強制的にドキュメントの先頭に生成されてしまうので、使い勝手が悪いです。
また、Page break after
オプションをオフにしても、次のように<!--BREAK-->
とセットで使えば、目次専用ページを任意の場所に作れるので、使いやすいです。
<!--BREAK-->
## 目次
<!--TOC-->
<!--BREAK-->
<!--TOC-->
よりも前に書いた見出しは目次の対象にならないので、目次に入れたくない項目は<!--TOC-->
よりも手前に書きます。例えば、次のよう感じです。
# 動作確認結果
A.Hayashi
本資料は、動作結果についてまとめている。
## 改訂履歴
- 2022年6月27日 新規作成
<!--BREAK-->
## 目次
<!--TOC-->
<!--BREAK-->
## 動作環境
動作環境は以下の通り。
## Beta1での結果
Beta1では問題なし
これをMarkedでプレビューでのページ区切り表示有りでレンダリングすると次のようになります。

目次の前後でページ区切りがあり、目次専用ページになっています。また、目次には改訂履歴
や目次
といった見出しが含まれていません。