Node reference
aozora exposes 19 NodeKind variants. Each is documented
on its own page with source examples, the rendered HTML, the
serialize round-trip output, the in-memory AST shape, and the
diagnostics it can fire alongside.
The page layout matches the aozora explain <kind> CLI subcommand:
once you find the variant in the table, the deep dive is one click —
or one shell invocation — away.
| Variant | Wire tag | Notation |
|---|---|---|
| Ruby | ruby | ｜base《reading》 |
| Bouten | bouten | ［＃「target」に傍点］ |
| TateChuYoko | tateChuYoko | ［＃「12」は縦中横］ |
| Gaiji | gaiji | ※［＃...、第3水準1-85-54］ |
| Indent | indent | ［＃2字下げ］ |
| AlignEnd | alignEnd | ［＃地から2字上げ］ |
| Warichu | warichu | ［＃割り注］... |
| Keigakomi | keigakomi | ［＃罫囲み］ |
| PageBreak | pageBreak | ［＃改ページ］ |
| SectionBreak | sectionBreak | ［＃改丁］ |
| AozoraHeading | heading | ［＃見出し］ |
| HeadingHint | headingHint | ［＃「対象」は中見出し］ |
| Sashie | sashie | ［＃挿絵（path.png）入る］ |
| Kaeriten | kaeriten | ［＃返り点 一・二］ |
| Annotation | annotation | ［＃任意のコメント］ |
| DoubleRuby | doubleRuby | 《《重要》》 |
| Container | container | ［＃ここから...］...［＃ここで...終わり］ |
| ContainerOpen | containerOpen | (NodeRef projection) |
| ContainerClose | containerClose | (NodeRef projection) |
How to read these pages
Every node page follows the same skeleton:
| Section | Content |
|---|---|
| Source examples | One or two minimal Aozora-notation strings that produce this variant. |
| Rendered HTML | What Document::new(src).parse().to_html() emits. |
| Serialize output | What serialize() emits — typically the canonical form of the source. |
| AST shape | The borrowed-AST struct fields the variant carries. |
| When emitted | Phase 3 classification rule that produces this variant. |
| Diagnostics | Codes that may accompany this variant. |
| Related kinds | Cross-links to neighbours (Bouten ↔ Bousen, Indent ↔ Container::Indent, etc.). |
#[non_exhaustive] on NodeKind: a future minor release adding a
new variant lands here without a breaking change. Downstream
consumers that match on NodeKind exhaustively must include a _
arm.