はじめに ドキュメントを書くための言語としておそらく今一番ポピュラーなのは Markdown だと思いますが、 かっちりした仕様書やユーザーマニュアルなど、より本格的なドキュメント作成にはやや機能不足と感じることがあります。 私も以前、ドキュメントを Gitbook で作れないか検討したことがあったんですが 表を書くのがめんどくさかったり、図のキャプションなどに対応していなかったことから断念しました。 そこで、今回は Markdown よりも表現力の高い言語として知られる AsciiDoc を試してみます。 AsciiDoc は O'reilly でも採用されているほか、Pro Git や JavaScript Promise の本 などの非常に完成度の高い技術ドキュメントが AsciiDoc で書かれています。 (参考記事) ・テクニカルライティングの未来を先取り ー Asciidoc
![AsciiDocによる継続的ドキュメント開発〜1.インストールと基本的な使い方 - dackdive's blog](https://cdn-ak-scissors.b.st-hatena.com/image/square/286bcd9d1351183059b1a051a4601c6cdc1d3cb9/height=288;version=1;width=512/http%3A%2F%2Fecx.images-amazon.com%2Fimages%2FI%2F516v0w26krL.jpg)