AsciiDoc サポート

guidebook は Markdown と並行して AsciiDoc(.adoc および .asciidoc)ファイルをサポートします。

使い方

SUMMARY.md で Markdown ファイルと同様に .adoc ファイルを参照:

# 目次

* [はじめに](README.md)
* [AsciiDoc チャプター](chapter.adoc)

サポートされる構文

guidebook の内蔵レンダラーで AsciiDoc をレンダリングします:

  • 見出し(= タイトル== セクション 等)
  • 段落とテキスト整形(*太字*_イタリック_`コード`
  • リスト(順序付き・順序なし)
  • コードブロック
  • リンクとクロスリファレンス
  • テーブル
  • 注釈(NOTE、TIP、WARNING、IMPORTANT、CAUTION)

フォーマットの混在

同じブック内で Markdown と AsciiDoc ファイルを自由に混在できます。各ファイルは拡張子に基づいて適切なパーサーでレンダリングされます。