LoginSignup
4

More than 5 years have passed since last update.

Markdown to PDF Converter (OSX, MacPorts)

Last updated at Posted at 2016-02-20

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

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

npm install markdown-pdf

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

環境

  • OS : 10.10 (Yosemite)
  • パッケージ管理ツール : MacPorts (2.3.4)
    • nodejs (4.3.1)
    • npm (2.14.19)

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

npmについて

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

インストール手順

Node.js

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

sudo port -d install nodejs

でNode.jsをインストール

npm

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

sudo port -d install npm

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

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

npm install <モジュール名>

markdown-pdf

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までパスを示してあげる必要性があるので、イケてません。

Stand-aloneモード

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の最後に記載されています。

PDF変換結果

markdown-pdf -o README.pdf README.md

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

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

その他、参考文献

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
4