WindowsでPandocをいれてみる

• Markdownを手軽にHTMLに変換したい
• かつて、DISCOUNTを使ったりしてみたのだが、結局Windowsマシンでも動かないと面倒なので、メジャーなPandocをいれてみる。

Pandocについて

• Dr. John MacFarlane によるドキュメント変換ツール。
• 基本的なライセンスはGNU GPLv2。ただしいろいろ例外があるようなので詳しく知りたければGitHubのCOPYWRIGHTを読むこと。
• 以下も参考になる。
  • Pandoc - About pandoc
  • Pandoc ユーザーズガイド 日本語版 - Japanese Pandoc User's Association
  • Pandoc - Wikipedia

環境

PS D:\>  "$((get-wmiobject win32_operatingsystem).caption) ($((get-wmiobject win32_operatingsystem).version))"
Microsoft Windows 10 Pro (10.0.17134)

PS D:\> $PSVersionTable.PSVersion

Major  Minor  Build  Revision
-----  -----  -----  --------
5      1      17134  228

実際にやること

ようはPandoc で Windows に作るmarkdown to html, docx 環境において書かれていることをやるだけ。

• github pandoc から最新版の Pandoc-x.yy.z-windows.msi をダウンロード。
• Pandoc-x.yy.z-windows.msi をインストール。
• システム環境変数 Path に 「C:\Users\UserName\AppData\Local\Pandoc」を通す。（※UserName は現在のログインユーザ名）

インストールされたことはpandoc --versionを実行して確認できる。

Markdown to HTML

細かいところはユーザガイドを読めばよいのでひとまず動かしてみる (ヘルプを表示するpandoc --helpはWindowsでは説明のないオプションの一覧だけなので)

# 完全なHTMLを作る(head,body,htmlタグあり))
pandoc ./test.md -f markdown -t html -o test.html -s

# 部分的なHTMLをつくる(パーツとしてのHTMLへの変換)
pandoc ./test.md -f markdown -t html -o test.html

# githubのmarkdownにしたい
pandoc ./test.md -f markdown_github -t html -o test.html

先送り事項

pandoc は　UTF8 を前提にしているのだが、日本語環境のPowershellの文字コードは932(Shift-JIS)。 このため標準出力に結果を出力すると文字化けする。

chcp 65001で文字コードをUTF-8にし、かつ日本語フォントを指定すれば良いかと思ったが、その場合は日本語を含むファイル名がつぶれる。

ひとまず、ファイルへの書き出しに問題はないので先送りとした。