AsciiDoc for humans & AI
生成AI と
生成AI と
いちばん相性のいい
文書形式
AsciiDoc(.adoc)は構造が明示的で、AI が書いても安定して出力する文書形式。 解説・プレイグラウンド付きで学べます。
ひと目でわかる構造
AsciiDoc は余白依存の Markdown と違い、見出し・アドモニション・テーブルが構文として明示的です。 そのため AI が出力した文章も安定して変換され、人と機械の両方に優しい文書になります。
= AI に書かせやすい文章 AsciiDoc は構造が明示的, AI が書いても安定して変換されます。 [NOTE] 生成 AI は .adoc の構造構文へ安定して出力できます。 == 見出しも明示的 [source,bash] $ asciidoctor my-doc.adoc DONE
AsciiDoc が AI と相性がいい理由
🗼
明示的な構造
見出し・テーブル・NOTE が構文として明確。Markdown の余白依存の曖昧さがありません。
⚙️
決定的変換
asciidoctor が決定的に HTML へ変換。AI 出力 → ビルド → 検証の自動化ができます。
📦
1 ソース多展開
.adoc 1 つから HTML / PDF / スライド(Reveal.js)を一律に生成できます。
Markdown との比較
| 観点 | AsciiDoc | Markdown の典型的な課題 |
|---|---|---|
| 構造表現 | 構文で明示 | 余白・記号の依存で曖昧 |
| 変換の決定性 | 決定論的で再現性あり | 方言 (dialects) で結果が変わる |
| 展開先 | HTML / PDF / スライド | 拡張に依存 |
はじめかた
- 「Playground」を開き、左のエディタに .adoc を書きます。
- 右のプレビューに HTML 変換結果がリアルタイムに表示されます。
- 「AsciiDoc を学ぶ」で書式の文法を確認します。