More than 5 years have passed since last update.

Markdown to PDF Converter (OSX, MacPorts)

Last updated at 2016-02-20Posted at 2016-02-20

アプリやスクリプトのREADMEをMarkdown形式で書くのですが、どなたでも読みやすいようにPDF形式に変換する'markdown-pdf'を導入しました。

結論から言うと、markdown-pdfに記載の通り、下記コマンドで終わりです。

npm install markdown-pdf

ただ私の場合、npm?ってなったのと、オプション-gでインストールしたのでその手順を記載します。

環境

(Note1) nodejs, npmはmarkdown-pdf導入にあたってインストールした際のバージョンを示しています。

npmは、JavaScriptのためのパッケージ管理ツールです。
gemもしくはpipと同じようなものです。

npmは、Node.jsインストール時に付属されているらしいので、

sudo port -d install nodejs

でNode.jsをインストール

上記コマンド実行後、port installedで確認しました。
しかしnpmは入っていなかったので、port search nodeでnpmが出てきたのを一応確認して、

sudo port -d install npm

でインストールしました。

モジュールのインストール方法は、下記コマンドです。

npm install <モジュール名>

npm install markdown-pdf

を実行すると、カレントディレクトリにnode_modulesが生成され、node_modules/markdown-pdf/bin/にmarkdown-pdfを確認しました。

ただ、現状だと

./node_modules/markdown-pdf/bin/markdown-pdf -o README.pdf README.md

のような実行方法になっていて、
実行ファイルmarkdown-pdfまでパスを示してあげる必要性があるので、イケてません。

markdown-pdfのREADMEを最後まで読むと、

To use markdown-pdf as a standalone program from the terminal run

npm install -g markdown-pdf

と書かれていました。

npm install -g markdown-pdf

だとPermission defineと出力されたので、

sudo npm install -g markdown-pdf

で無事完了しました。

使い方は、markdown-pdfのREADMEの最後に記載されています。

markdown-pdf -o README.pdf README.md

でPDFに変換すると、下記図のように無事にPDF形式のファイルが出力されました。

(Note2) PDFファイルは添付できなかったので、png形式に変換しました。また、画像の空白部分は切り取っています。