AsciiDoc は Markdown と同じ軽量マークアップ言語の一種です。仕様書などの文書を書く上ではMarkdownより利点・メリットがあると感じていて、もともと Markdown で仕様書などを書いていましたが、今は AsciiDoc へ移行しました。 今では、 メモ、README など簡単なテキスト、ブログ記事書き => Markdown 仕様書などある程度分量のある文書 => AsciiDoc というすみ分けをしています。 Markdown と AsciiDoc を使ってみてわかった、AsciiDoc の良いところを 4つ記載します。 仕様が明確 AsciiDoc は仕様が明確です。どういう表現があるのか、どういう書き方をすれば良いか、公式のユーザガイドを見れば全て記載があります。 Markdown は方言が多いため、一言で Markdown 対応のツールと言っても対応している