VSCodeのMarkdownからのPDF変換エラー解決＆改ページ

概要

• PDF生成にchromiumを指定する方法
• PDF上で改ページするためにCSSを設定する方法

環境

• macOS Mojave 10.14.5
• Visual Studio Code 1.35.1
• Markdown PDF 1.2.0
  • https://github.com/yzane/vscode-markdown-pdf

PDFを生成できるようにする

VSCodeで書いたMarkdownファイルからPDF生成しようとするとnewpageエラーで，tmpのHTMLが生成された状態で止まってしまう．今までは不便に思いつつもHTML生成を実行した後，ブラウザで開いてPDF化していた．

homebrewでchromiumをインストール

$ brew cask install chromium

（ブラウザはお好みで．元々入れていたGoogle Chromeを指定しても動作した）

VSCodeのsettings.jsonに以下を追記

"markdown-pdf.executablePath": "/Applications/Chromium.app/Contents/MacOS/Chromium"

これで，Export (pdf)した時にエラーで終了しない．

水平線を改ページにする

調べると，以下をMarkdown中に記述することで改ページできることは分かったが，スニペットとか使いこなせていないので，Markdownだけで実現したい．

<div style="page-break-before:always"></div>

PDF用のCSSを用意する

hr {
    border: none;
    page-break-after: always;
}

これを任意の場所に保存する．（ここでは，/Users/sampleuser/Documents/markdown-pdf.css）

VSCodeのsettings.jsonに以下を追記

"markdown-pdf.styles": ["/Users/sampleuser/Documents/markdown-pdf.css"]

使い方

以下のように水平線---を入れたところがPDFでは改ページになる．

1ページ目

---

2ページ目