軽量マークアップ言語でメジャーといえばmarkdown
だけど、より高度な文書の論理構造を構築することが可能なAsciiDoc
が良き。
公式にあるのだけど自分の理解も兼ねてのチートシート作った。
ついでにAsciiDoc
執筆環境をbundler
で揃えた。
チートシート
github pagesにデプロイした。
https://tommylife88.github.io/asciidoc/
執筆環境
Ruby bundlerを使う。
bundle install
を実行するだけで、Asciidoctor
などの周辺ツールをサンドボックス環境で揃えることができる。Gemfile.lock
ファイルも置いたので環境を再現しやすいように。
せっかくなのでRakefile
でHTMLやPDF変換をタスク化している。