構築メモ。環境はWindows 10です。
インストール
- pandocのインストール
- 「Pandoc - Installing pandoc」から「Download the latest installer for Windows (64-bit)」のリンクでインストーラーをダウンロード
- インストーラーを起動し、ウィザードに沿ってインストール実行。
- コマンドラインかPowerShellを開き、
pandoc --version
でバージョン表示が出る(インストールができている)ことを確認する。
- VScodeのプラグインのインストール
- VScodeを起動
- プラグイン画面で
vscode-pandoc
を検索 - 見つかったプラグインをインストール(複数見つかったので
Chris Chinchilla
のものを入れた)
docker使用オプションの無効化とHTMLへの変換
最近Dockerサポートが加わったらしくて、デフォルトでこれが有効化されてて、以下のエラーになった。
exec error: Error: Command failed: docker run --rm -v (略)
前提条件部に書かれてる useDocker
オプションを無効化すればよさそうな気がする。
You need to install Pandoc - a universal document converter.
Alternatively you may set theuseDocker
option to true and the extension runs Pandoc in a container using the latest official pandoc/latex image.
これで特別なレンダリングエンジンが要らなそうなMarkdownからHTMLへの変換をしてみる。
- VScodeを起動
- 任意のMarkdownファイルを開く
-
Ctrl
+P
でコマンドパレットを開き、Pandoc Render
を選択 - レンダリング形式に
html
を指定
Word(.docx)への変換
上のHTMLへの変換が成功していれば、残る前提条件はWordがインストールされていること。
- VScodeを起動
- 任意のMarkdownファイルを開く
-
Ctrl
+P
でコマンドパレットを開き、Pandoc Render
を選択 - レンダリング形式に
docs
を指定
PDFへの変換
PDFに変換するには pdflatex
かその代わりになる変換エンジンが要るらしくて、以下のエラーになった。
exec error: Error: Command failed: "pandoc" "Markdownファイルのパス.md" -o "PDFファイルのパス.pdf" pdflatex not found. Please select a different --pdf-engine or install pdflatex
- Windows - TeX Live - TeX Users Groupから「install-tl-windows.exe」をダウンロード。
- 実行し、ウィザードに沿ってインストール。
インストール進行状況が表示されるけど「0250/4538」とか「time/total: 05:51/1:18:42」とか出てて、どんだけって気持ちになる。でもまあ、見守る。見守らないで、なにか他のことしてきてもいい。私の環境では「4538/4538」と最後まで来たとき、時間の方は「02:07:12/02:07:12」だった。
vscode-pandocにPDF生成時のエンジンの設定を入れていくけど、日本語PDFを生成するにはもうひと手間必要らしくて、 pdflatexe
より lualatex
を使うのが手軽そう。関連情報はこことかここ。
- VScodeを起動。
- プラグイン画面で
vscode-pandoc
を右クリックし「拡張機能の設定」を開く。 - 「Pandoc: Pdf Opt String」に
--pdf-engine=lualatex -V documentclass=ltjsarticle -V luatexjapresetoption=ms
を指定する。
これでMarkdownからPDFへの変換をしてみる。
- VScodeを起動(再起動)。
- 任意のMarkdownファイルを開く。
-
Ctrl
+P
でコマンドパレットを開き、Pandoc Render
を選択。 - レンダリング形式に
html
を指定。
参考情報
以下を参考にした。
- VScode+pandoc+Lualatexで日本語pdfをMarkdownから出力する - Qiita
- メモ: Pandoc+LaTeXで気軽に日本語PDFを出力する - Qiita
- TeX Live/Windows - TeX Wiki
- TeX Live 2023のインストール · Obsica
- 重点解説! TeX Live 2023はココが違う! - Qiita
この先はPandocの使いこなしになるけど、参考にしたいところをメモしておく。