Markdown Markdown PDF PDF Visual Studio Code

Markdown PDFのすすめ

Markdown PDFは、yzaneさんの作成したVisual Studio Code（以下VSCode）用の拡張機能で、Markdown記法で書かれた文書をPDFに出力します。  [こちら](https://github.com/yzane/vscode-markdown-pdf/blob/master/README.ja.md)に日本語の説明があります。 インストール方法については、リンク先の「インストール」を読んでください。 Markdown記法の文書をPDFにして紙で出力することができるのは、何かと便利です。 あと、ver1.0.0以降においてPDF変換が、`node-html-pdf`から`puppeteer`に変更されたようなので注意が必要です。私がそうでしたが、いきなり出力されたPDFの見た目が変わり驚きました。 その後もいろいろと変更されているようです。なかなかついていけないので、デフォルトで使うようにしています。複雑な文書はAsciiDocを利用することが増えました。[こちら](https://waku-take-a.github.io/AsciiDoc.html)に記事を書いています。 ## Markdown記法とプレビュー Googleなどの検索サイトで、「Markdown 記法」と入力すれば多数ヒットします。 Markdown記法は、Github拡張・Qiita拡張などの方言がありますので、汎用的な文書にしたい場合には基本的な記述のみで書くのが良いかもしれません。 表示確認は、`VSCode`右上の「プレビューを横に表示」ボタンを押してください。  以下のように表示されます。  ## 改ページの方法 PDF出力する際に特定の場所で改ページしたいことは良くあります。 改行したい箇所に、以下を貼り付けてください。 ``` <div style="page-break-before:always"> </div> ``` 上の例は、スタイルシートの`page-break-before`プロバティを使っていますが、`page-break-after`プロバティを使うこともできます。 「表紙」の後ろに入れてみます。正常動作すれば、以下のように改ページされます。 入れない場合、  入れた場合、  ちなみに、ver1.05あたりから以下でも改ページされるようになったようです。 ``` <div class="page"/> ``` ## ヘッダーやフッターの編集 まず、編集する`*.md`はフォルダに入れ、`VSCode`のフォルダを開くから開いてください。 `VSCode`のファイル⇒基本設定⇒設定。  ワークスペースを選択し、設定の変更、もしくは、「`settings.json`で編集」でワークスペースに作成されます。 この`settings.json`で、フォルダ毎に`VSCode`のカスタマイズが可能になります。これは、他の言語の編集（たとえば`Python`）でも有効な編集方法になります。 設定の検索に、markdown-pdfと記入すれば所望の設定が表示されます。 ヘッダーやフッターの設定を行う場合の例を下にあげます。 ``` // 既定の設定とユーザー設定を上書きするには、このファイル内に設定を挿入します { // ヘッダーとフッタ－の表示 "markdown-pdf.displayHeaderFooter": true, // ヘッダー コンテンツ "markdown-pdf.headerTemplate": "<div style=\"font-size: 9px; margin-left: 1cm;\"> <span class='title'></span></div> <div style=\"font-size: 9px; margin-left: auto; margin-right: 1cm; \"> <span class='date'></span></div>", // フッター コンテンツ "markdown-pdf.footerTemplate": "<div style=\"font-size: 9px; margin: 0 auto;\"> <span class='pageNumber'></span> / <span class='totalPages'></span></div>" } ``` サンプルを[こちら](https://github.com/WAKU-TAKE-A/ExampleOfMarkdownPDF)に置いておきます。`VSCode`のファイル ⇒ フォルダを開くで開いてください。 ## ひとこと 簡易な文書なら、Markdownで書いてPDF出力すればWordなんか使う必要はない、と思ってしまいます。