` を指定しても著者の入力どおりに描画されます。出力時、記号に含まれる `"` と `\` は CSS 文字列規則（および `style` 属性内では HTML 属性規則）に従ってエスケープしなければなりません（MUST）。
`text-emphasis-position: over right` places marks above the text in horizontal writing and to the right in vertical writing.
`text-emphasis-position: over right` により、横書きでは文字の上、縦書きでは右側に傍点が付きます。
---
## 5. No-break 「改行抑止」
Prevents a line break from occurring inside a proper noun or fixed phrase.
固有名詞や熟語の途中で改行が入らないようにします。
### Syntax / 構文
```
[[no-break:テキスト]]
```
### Examples / 例
```markdown
[[no-break:東京都新宿区]]に住んでいます。
事件名は[[no-break:被愛妄想罪]]です。
```
### HTML Output / HTML 出力
```html
東京都新宿区
```
```css
.mdi-nobr {
white-space: nowrap;
word-break: keep-all;
}
```
---
## 6. Explicit Line Break 「改行マーカー」
### Overview / 概要
MDI distinguishes two kinds of breaks:
| Type | MDI | Meaning |
|------|-----|---------|
| **Line break** (改行) | `[[br]]` | Break within a paragraph — stays in the same `` |
| **Paragraph break** (換段) | blank line | CommonMark blank line — starts a new `
` |
MDI では「改行」と「換段」を明確に区別します。
| 種別 | MDI | 意味 |
|------|-----|------|
| **改行** | `[[br]]` | 段落の中で行を折り返す（同じ `
` に留まる） |
| **換段** | 空行 | CommonMark の空行 — 新しい `
` が始まる |
### `[[br]]` — Inline Line Break / 段落内改行
Insert `[[br]]` anywhere inside a paragraph to force a line break.
段落の途中に `[[br]]` を挿入すると、その位置で強制改行されます。
```markdown
春は曙。[[br]]
やうやう白くなりゆく山ぎは、少し明かりて、
```
**HTML Output:**
```html
春は曙。
やうやう白くなりゆく山ぎは、少し明かりて、
```
**Notes / 注意事項:**
- `.mdi` files only — has no effect in `.md` files.
- Valid only in inline (paragraph) context; ignored at block level.
- Multiple consecutive `[[br]][[br]]` inserts multiple line breaks.
- Inside ruby syntax `{base|ruby}`, `[[br]]` is treated as a literal string.
- Inside fenced code blocks and inline code, `[[br]]` is preserved as literal text.
- `[[br]]` is preferred over trailing two-space hardbreak (` \n`), which is fragile across external tools and copy-paste.
---
- `.mdi` ファイル専用。`.md` では効果なし。
- inline（段落）コンテキストのみ有効。ブロックレベルでは無視。
- `[[br]][[br]]` と連続させると複数回の改行として扱われます。
- ルビ構文 `{親文字|ルビ}` 内では `[[br]]` はリテラル文字列として扱われます。
- コードブロック・インラインコード内ではリテラルとして保持されます。
- 末尾 2 スペース改行 (` \n`) はコピペや外部ツールで失われやすいため、`.mdi` では `[[br]]` を推奨します。
### Paragraph Break / 換段
Use a **blank line** (CommonMark) to start a new paragraph. MDI does not introduce a native `[[pr]]` syntax for this — a blank line is sufficient and universally compatible.
段落を分けるには CommonMark に準拠した**空行**を使います。MDI 独自の換段マーカーは設けていません。
```markdown
春は曙。やうやう白くなりゆく山ぎは。
夏は夜。月のころはさらなり。
```
---
## 7. Blank Paragraph 「空白段落」
*Revised in 2.0.*
A blank paragraph is an intentional empty line in the rendered output — commonly used in fiction to leave vertical space between scenes.
空白段落は、描画結果に意図的な空行を残すためのものです。小説で場面の間に余白を置く用途が典型です。
### Syntax / 構文
**Recommended / 推奨:**
A line consisting of only a backslash `\` is one blank paragraph.
`\` 一文字だけの行が、空白段落 1 つになります。
```markdown
春は曙。
\
夏は夜。
```
**Each `\` line counts as exactly one blank paragraph.** N consecutive `\` lines produce N empty paragraphs, whether or not blank lines separate them.
**`\` の行 1 つが空白段落 1 つに対応します。** `\` の行を N 行連続させると N 個の空段落になります（間に空行を挟んでも挟まなくても同じ）。
```markdown
春は曙。
\
\
\
夏は夜。
```
→ three empty paragraphs between the two sentences. / 2 つの文の間に空段落が 3 つ入ります。
**Supported forms / 互換記法:**
| Form | Status | Behavior |
|------|--------|----------|
| `
` / `
` alone on a line | Supported | One blank paragraph. Typically produced by HTML paste; normalized to `\` on save / 保存時に `\` へ正規化 |
| `[[blank]]` | Supported (v1.0) | One blank paragraph; normalized to `\` on save / 保存時に `\` へ正規化 |
**Parsing rules / 解析規則:**
- A blank paragraph line matches `^\\[ \t]*$` — a single backslash, optionally followed by trailing whitespace.
空白段落の行は `^\\[ \t]*$`（バックスラッシュ 1 文字＋任意の行末空白）に一致する必要があります。
- A blank paragraph line is always a **block boundary**: it terminates the current paragraph even without a preceding blank line.
空白段落の行は常に**ブロック境界**です。直前に空行がなくても、その時点で段落は終了します。
```markdown
春は曙。
\
夏は夜。
```
→ 「春は曙。」 and 「夏は夜。」 are separate paragraphs with one blank paragraph between them. / 「春は曙。」と「夏は夜。」は別々の段落になり、間に空段落が 1 つ入ります。
### Behavior / 挙動
| Context | Behavior |
|---------|----------|
| Editor | Rendered as an editable empty paragraph (`
`) |
| TXT export | Empty line |
| HTML export | `
` |
| DOCX export | Empty paragraph |
| コンテキスト | 挙動 |
|------------|------|
| エディタ | 編集可能な空段落 (``) として描画 |
| TXT 出力 | 空行 |
| HTML 出力 | `
` |
| DOCX 出力 | 空段落 |
```css
.mdi-blank {
min-block-size: 1lh; /* an empty otherwise collapses to zero height */
}
```
**Notes / 注意事項:**
- `.mdi` files only. In standard Markdown a lone `\` renders as a literal backslash — this semantic is MDI-specific.
`.mdi` ファイル専用。標準 Markdown では `\` 単独の行はリテラルの `\` として描画されます。この意味づけは MDI 固有です。
- This is distinct from the CommonMark **trailing** backslash (`text\` at end of line = hard break inside a paragraph). A `\` line contains nothing else.
CommonMark の**行末**バックスラッシュ（`テキスト\` = 段落内の強制改行）とは別物です。空白段落の `\` は行にそれ以外の文字を含みません。
- Inside fenced code blocks and blockquotes, `\`, `
`, and `[[blank]]` are preserved as literal text.
コードブロック・引用ブロック内ではすべてリテラルとして保持されます。
---
## 8. Warichu 「割注」
*New in 2.0.*
Warichu is an inline annotation set in two half-height lines within the line of text — a traditional Japanese typographic device for short notes.
割注は、本文の行内に二行組の小さな注記を挿入する伝統的な組版手法です。
### Syntax / 構文
```
[[warichu:テキスト]]
```
### Examples / 例
```markdown
その日は大安[[warichu:六曜の一つで吉日とされる]]であった。
```
### HTML Output / HTML 出力
```html
六曜の一つで吉日とされる
```
```css
.mdi-warichu {
display: inline-block;
font-size: 0.5em;
line-height: 1.1;
max-inline-size: 10em;
vertical-align: middle;
text-align: start;
}
```
CSS has no native warichu support; the inline-block approximation above wraps the note into two short lines. Renderers targeting formats with native warichu (e.g. InDesign, some EPUB readers) should map it directly.
CSS に割注のネイティブサポートはないため、上記の inline-block による近似で二行組を再現します。割注をネイティブに持つ出力先（InDesign 等）ではそちらへマップします。
---
## 9. Kerning 「字間調整」
Adjusts letter-spacing for a specific run of text.
特定の文字列の字間（letter-spacing）を調整します。
### Syntax / 構文
```
[[kern:<量>:<文字列>]]
```
- `<量>`: an `em` value, e.g. `-0.1em`, `+0.2em`, `0em`.
- `<文字列>`: the text to which kerning is applied.
### Examples / 例
```markdown
彼は[[kern:-0.1em:確実]]にそう言った。
[[kern:+0.3em:沈黙]]が落ちた。
[[kern:0em:通常]]の字間。
```
### HTML Output / HTML 出力
```html
確実
```
```css
.mdi-kern {
letter-spacing: var(--mdi-kern, 0em);
}
```
**Validation / バリデーション:**
`<量>` must match `^[+-]?\d+(\.\d+)?em$`. Invalid values are treated as plain text.
`<量>` は `^[+-]?\d+(\.\d+)?em$` に一致する必要があります。無効な値はリテラル文字列として扱われます。
---
## 10. Block Alignment 「字下げ・地付き」
*New in 2.0.*
Controls indentation and end-alignment of a paragraph — used for colophons, signatures, poetry, and epigraphs.
段落の字下げ・地付き・字上げを指定します。奥付・署名・和歌・題辞などに使います。
### Syntax / 構文
A block alignment macro is written **on its own line, immediately before the paragraph it modifies**.
ブロック指定マクロは、**対象の段落の直前に単独の行として**書きます。
```
[[indent:N]] ... N字下げ (indent N characters from the line head)
[[bottom]] ... 地付き (align to the line end / bottom in vertical)
[[bottom:N]] ... 地からN字上げ (align N characters up from the line end)
```
`N` is a positive integer (number of characters). The macro applies to exactly one following block; it does not cascade.
`N` は正の整数（字数）です。マクロは直後の 1 ブロックだけに適用され、それ以降には及びません。
### Examples / 例
```markdown
[[indent:2]]
我輩は猫である。名前はまだ無い。
[[bottom]]
著者識
[[bottom:2]]
令和七年七月
```
`[[indent:N]]` indents **every line** of the block (JIS「字下げ」 for a block). The conventional **first-line** indent of a Japanese paragraph is written as a literal full-width space (` `) at the head of the paragraph, as usual — no macro is involved.
`[[indent:N]]` はブロックの**全行**を字下げします（ブロックの字下げ）。段落冒頭の慣習的な**一字下げ**は、従来どおり行頭に全角スペース（` `）を書きます。マクロは使いません。
### HTML Output / HTML 出力
```html
我輩は猫である。名前はまだ無い。
著者識
令和七年七月
```
```css
.mdi-indent {
margin-inline-start: calc(var(--mdi-indent, 0) * 1em);
}
.mdi-bottom {
text-align: end;
margin-inline-end: calc(var(--mdi-shift, 0) * 1em);
}
```
In vertical writing, `end` = the bottom of the column (地), so the same output works for both writing modes.
縦書きでは `end` が行末（地）になるため、同一の出力が縦横両対応になります。
**Notes / 注意事項:**
- A block alignment macro line is always a **block boundary**, like the blank-paragraph `\` line (§7): it terminates the current paragraph even without a preceding blank line, and is never absorbed into the preceding paragraph as continuation text.
ブロック指定マクロの行は、空白段落の `\` 行（第7節）と同様、常に**ブロック境界**です。直前に空行がなくても、その時点で段落は終了し、前の段落の継続行として吸収されることはありません。
- A block alignment macro not followed by a paragraph is treated as plain text. This includes a block macro followed by another block macro line — **stacking is not allowed** (`[[indent:2]]` and `[[bottom]]` are mutually exclusive by nature).
直後に段落が続かない場合はリテラル文字列として扱います。ブロックマクロの直後に別のブロックマクロ行が来る場合も同様で、**重ね掛けはできません**（字下げと地付きは本来排他です）。
- Invalid `N` (zero, negative, non-integer) → plain text.
無効な `N`（0・負数・非整数）はリテラル扱いです。
---
## 11. Page Break 「改ページ」
*New in 2.0.*
Forces a page break in paginated output (EPUB / PDF / DOCX). Continuous media (web) may render it as extra vertical space or ignore it.
ページ概念のある出力（EPUB / PDF / DOCX）で改ページを強制します。Web などの連続メディアでは余白として描画するか無視します。
### Syntax / 構文
Written on its own line, as a block.
単独の行にブロックとして書きます。
```
[[pagebreak]] ... 改ページ
[[pagebreak:right]] ... 改丁 — next page must be a right-hand page (recto)
[[pagebreak:left]] ... 改丁 — next page must be a left-hand page (verso)
```
### Examples / 例
```markdown
第一章はここで終わる。
[[pagebreak]]
第二章が始まる。
```
### HTML Output / HTML 出力
```html
```
```css
.mdi-pagebreak { break-after: page; }
.mdi-pagebreak-right { break-after: recto; }
.mdi-pagebreak-left { break-after: verso; }
```
`recto` / `verso` have limited CSS support; EPUB and DOCX exporters map 改丁 to the format's native page-break properties.
`recto` / `verso` の CSS サポートは限定的です。EPUB・DOCX エクスポータでは各形式のネイティブな改ページ属性にマップします。
**Notes / 注意事項:**
- A `[[pagebreak]]` line is always a **block boundary**, like the blank-paragraph `\` line (§7): it terminates the current paragraph even without a preceding blank line.
`[[pagebreak]]` の行は、空白段落の `\` 行（第7節）と同様、常に**ブロック境界**です。直前に空行がなくても、その時点で段落は終了します。
---
## 12. Footnotes 「脚注」
*New in 2.0.*
MDI **inherits** the GFM / Pandoc footnote syntax — no MDI-specific notation is introduced.
脚注は GFM / Pandoc の記法を**そのまま継承**します。MDI 固有の記法は導入しません。
### Syntax / 構文
```markdown
彼はその話を信じなかった[^1]。
[^1]: 後に事実と判明する。
```
### Rendering / 描画
| Context | Behavior |
|---------|----------|
| Horizontal writing 横書き | Footnotes collected at the end of the document (endnotes) / 文書末にまとめて配置 |
| Vertical writing 縦書き | Same — rendered as endnotes; renderers **may** offer 傍注 (margin notes) as an option / 同じく文書末。レンダラーはオプションで傍注に対応してもよい |
| EPUB export | `epub:type="footnote"` pop-up footnotes / ポップアップ脚注 |
### HTML Output / HTML 出力
```html
彼はその話を信じなかった1。
...
```
---
## 13. Escapes 「エスケープ」
Prepend `\` to write MDI delimiter characters as literal text.
MDI の区切り文字をリテラルとして書くには `\` を前置します。
| Escape | Literal |
|--------|---------|
| `\{` | `{` |
| `\}` | `}` |
| `\|` | `|` |
| `\^` | `^` |
| `\[` | `[` |
| `\]` | `]` |
| `\:` | `:` |
| `\《` | `《` |
| `\》` | `》` |
**Normative in 2.0:** escape processing runs **once, first**, before any MDI inline parsing, and behaves identically through every API and renderer. An escaped character never participates in any MDI delimiter match.
**2.0 での規範:** エスケープ処理はすべての MDI インライン解析に**先立って一度だけ**実行され、すべての API とレンダラーで同一に動作します。エスケープされた文字はいかなる MDI 区切り文字のマッチにも参加しません。
**Exception — GFM table cells:** inside a table cell, `\|` is consumed by **GFM's own table parsing** at the block stage (it is the cell-separator escape), which runs before MDI escape processing. The `|` it produces is an ordinary character and **does** participate in MDI inline matching — this is what makes `{東京\|とうきょう}` in a cell produce normal ruby (see §2). Consequently, a *literal* `|` inside ruby syntax within a table cell is not expressible; move such content out of the table or restructure the ruby.
**例外 — GFM 表セル:** 表のセル内の `\|` は、MDI エスケープ処理より前のブロック段階で **GFM 自身の表解析**が消費します（セル区切りのエスケープ）。その結果生じる `|` は通常の文字であり、MDI インライン解析に**参加します** — セル内の `{東京\|とうきょう}` が通常のルビになるのはこのためです（第2節参照）。この帰結として、表セル内のルビ構文の中に*リテラルの* `|` を書くことはできません。その場合は表の外に出すか、ルビの構成を変えてください。
---
## 14. Quick Reference / クイックリファレンス
| Feature | Syntax | Example |
|---------|--------|---------|
| **Ruby (group)** ルビ（グループ） | `{base\|ruby}` | `{東京\|とうきょう}` |
| **Ruby (split)** ルビ（分割） | `{base\|r.u.by}` | `{東京\|とう.きょう}` |
| **Tate-chu-yoko** 縦中横 | `^text^` | `第^12^話` |
| **Boten** 傍点 | `[[em:text]]` / `[[em::text]]` | `[[em:それ]]` |
| **No-break** 改行抑止 | `[[no-break:text]]` | `[[no-break:新宿区]]` |
| **Line break** 改行 | `[[br]]` | `曙。[[br]]やうやう` |
| **Paragraph break** 換段 | blank line | `（空行）` |
| **Blank paragraph** 空白段落 | `\` (own line) | `\` |
| **Warichu** 割注 | `[[warichu:text]]` | `[[warichu:注記]]` |
| **Kerning** 字間調整 | `[[kern::text]]` | `[[kern:-0.1em:言葉]]` |
| **Indent** 字下げ | `[[indent:N]]` | `[[indent:2]]` |
| **Bottom align** 地付き・字上げ | `[[bottom]]` / `[[bottom:N]]` | `[[bottom:2]]` |
| **Page break** 改ページ | `[[pagebreak]]` / `[[pagebreak:right\|left]]` | `[[pagebreak]]` |
| **Footnote** 脚注 | `[^id]` (GFM) | `[^1]` |
**Supported alternates / 互換記法** (always accepted; normalized to the recommended form on save / 常に受理され、保存時に推奨記法へ正規化):
| Alternate | Recommended form |
|-----------|------------------|
| `[[blank]]` | `\` (own line) |
| `
` alone on a line | `\` (own line) |
| `《《text》》` | `[[em:text]]` |
---
## CSS Class Summary / CSS クラス一覧
| Class | Feature |
|-------|---------|
| `.mdi-ruby` | Ruby base element |
| `.mdi-tcy` | Tate-chu-yoko |
| `.mdi-em` | Boten (uses `--mdi-em` CSS variable) |
| `.mdi-nobr` | No-break span |
| `br.mdi-break` | Explicit line break |
| `.mdi-blank` | Blank paragraph |
| `.mdi-warichu` | Warichu inline note |
| `.mdi-kern` | Kerning span (uses `--mdi-kern` CSS variable) |
| `.mdi-indent` | Indented block (uses `--mdi-indent`) |
| `.mdi-bottom` | Bottom-aligned block (uses `--mdi-shift`) |
| `.mdi-pagebreak` | Page break |
| `.mdi-fnref` / `.mdi-footnotes` | Footnote reference / footnote section |
---
## TXT Export Flavors / TXT 書き出しフレーバー
*New in 2.0.*
HTML/PDF/EPUB share one CSS-driven rendering model, but plain text has no styling layer — every MDI construct must be flattened to a specific textual convention, and more than one such convention is in real-world use. Conforming TXT exporters SHOULD support at least the following five flavors. Any MDI construct with no equivalent in a given flavor is flattened to its base text (macro dropped, content kept).
HTML・PDF・EPUB は同じ CSS 駆動の描画モデルを共有しますが、プレーンテキストにはスタイル層がなく、MDI の各構成要素を具体的な文字表現へフラット化する必要があります。その表現の慣例は実務上一つではありません。**準拠する TXT エクスポータは、少なくとも以下 5 種類のフレーバーをサポートすることが望ましい（SHOULD）。** あるフレーバーに対応する慣例がない構成要素は、マクロを除去し中身のテキストのみを残します（フラット化）。
| Flavor | Purpose / 用途 |
|--------|----------------|
| `plain` | Simplest export: ruby discarded, every macro flattened to base text. / 最も単純な書き出し。ルビは破棄。 |
| `ruby-paren` | Ruby rendered as fullwidth parentheses: `漢字（かんじ）`. / ルビを全角括弧で表現。 |
| `narou` | 小説家になろう submission format. Ruby via `｜《》`; boten via per-character dot ruby (the site has no boten notation). / 小説家になろうの投稿フォーマット。ルビは `｜《》`、傍点はサイトに専用記法がないため一字ずつの圏点ルビで表現。 |
| `kakuyomu` | カクヨム submission format. Ruby via `｜《》`; boten via the site's native `《《》》` notation. / カクヨムの投稿フォーマット。ルビは `｜《》`、傍点はサイト固有の `《《》》` 記法。 |
| `aozora` | Aozora Bunko (青空文庫) annotation ("注記") convention. / 青空文庫注記形式。 |
`narou` and `kakuyomu` differ **only** in the boten row below — every other construct maps identically. They are separate flavors because each site renders only its own convention: なろう displays `《《それ》》` as literal brackets, and カクヨム has no need for the ruby workaround.
`narou` と `kakuyomu` の違いは下表の**傍点の行のみ**で、他の構成要素はすべて同一です。各サイトは自サイトの慣例しか描画しないため（なろうでは `《《それ》》` が括弧のまま表示される）、別フレーバーとして分けています。
### Mapping table / 対応表
| MDI | `plain` | `ruby-paren` | `narou` | `kakuyomu` | `aozora` |
|-----|---------|--------------|---------|------------|----------|
| `{東京\|とうきょう}` (group ruby) | `東京` | `東京（とうきょう）` | `｜東京《とうきょう》` | same as narou | `東京《とうきょう》` (pure-kanji base; `｜` only needed to disambiguate a mixed-script base) |
| `{東京\|とう.きょう}` (split ruby) | `東京` | `東京（とうきょう）` (dots removed) | `｜東《とう》｜京《きょう》` | same as narou | `東《とう》京《きょう》` (each character annotated individually — no platform has a "one ruby over N characters, split by dot" primitive) |
| `^12^` (tate-chu-yoko) | `12` | `12` | `12` (no convention; flattened) | same as narou | `12［＃「12」は縦中横］` |
| `[[em:それ]]` (boten, default mark) | `それ` | `それ` | `｜そ《・》｜れ《・》` (per-character dot ruby — the only boten device なろう renders; the `` character is not representable and is dropped) | `《《それ》》` (native Kakuyomu notation — the §4 Supported alternate, used verbatim; `` not representable) | `それ［＃「それ」に傍点］` (marks recognized from aozora's own vocabulary, e.g. `●`→`丸傍点`, `﹆`→`白ゴマ点`, map to that name; an unrecognized `` falls back to the generic `に傍点`) |
| `[[no-break:...]]` | text kept, macro dropped | same | same | same | same (no aozora equivalent) |
| `[[br]]` | `\n` | `\n` | `\n` | `\n` | `\n` |
| `\` (blank paragraph) | blank line | blank line | blank line | blank line | blank line |
| `[[warichu:text]]` | text kept, macro dropped | same | same (no convention) | same | `［＃割り注］text［＃割り注終わり］` (aozora's native two-line-note construct) |
| `[[kern::text]]` | text kept, macro dropped | same | same | same | same (no aozora equivalent — kerning is a rendering-only concern) |
| `[[indent:N]]` | implementation-defined | same | same (no convention) | same | `［＃ここからN字下げ］` … `［＃ここで字下げ終わり］` |
| `[[bottom]]` / `[[bottom:N]]` | implementation-defined | same | same (no convention) | same | `［＃地付き］` / `［＃地からN字上げ］` |
| `[[pagebreak]]` | blank line or dropped (implementation-defined) | same | same (no convention) | same | `［＃改ページ］` |
| `[^id]` (footnote) | implementation-defined (e.g. inline number + note appended at document end) | same | same | same | same |
Implementations MAY offer additional flavors beyond these five; they are the minimum interoperability baseline so that `.mdi → txt` conversions stay predictable across tools.
実装はこれ以外のフレーバーを追加してもよい（MAY）。上記 5 種類は、`.mdi → txt` の変換がツール間で予測可能であるための最小限の相互運用ベースラインです。
---
## Parsing Order / パース順序
Implementations should process MDI syntax in the following order:
実装では、以下の順序で MDI 構文を処理することを推奨します。
**Block stage / ブロック段階:**
1. Front matter / フロントマター
2. Standard Markdown block structure (paragraphs, code blocks, blockquotes, thematic breaks…) / 標準 Markdown のブロック構造
3. Blank paragraph lines: `\`, `
`, `[[blank]]`
4. Block macros: `[[pagebreak]]`, `[[indent:N]]`, `[[bottom]]`, `[[bottom:N]]`
**Inline stage / インライン段階 (inside each paragraph):**
5. Escape processing / エスケープ処理
6. Ruby: `{base|ruby}`
7. Boten alias: `《《...》》`
8. Tate-chu-yoko: `^...^`
9. Bracket macros: `[[br]]`, `[[no-break:...]]`, `[[em:...]]`, `[[warichu:...]]`, `[[kern:...:...]]`
10. Footnote references: `[^id]`
### Inline Nesting / インラインの入れ子
*Normative in 2.0.*
- **Bracket macro content is MDI inline content.** The content of `[[em:...]]`, `[[no-break:...]]`, `[[warichu:...]]`, and `[[kern:...:...]]` is parsed as MDI inline syntax — ruby, tate-chu-yoko, and other bracket macros may appear inside. `[[em:{東京|とうきょう}]]` places boten on ruby-annotated text.
**ブラケットマクロの内容は MDI インライン内容です。** `[[em:...]]`・`[[no-break:...]]`・`[[warichu:...]]`・`[[kern:...:...]]` の内容は MDI インライン構文として解析され、ルビ・縦中横・他のブラケットマクロを含められます。`[[em:{東京|とうきょう}]]` はルビ付きテキストに傍点を打ちます。
- **Closing is balanced.** A bracket macro closes at its *matching* `]]`: `[[` / `]]` pairs nest by counting, and escaped brackets (`\[`, `\]`) do not participate. In `[[em:foo[[no-break:bar]]baz]]`, the first `]]` closes `no-break`, the second closes `em`.
**閉じ括弧は対応で決まる。** ブラケットマクロは*対応する* `]]` で閉じます。`[[` / `]]` の対はカウントで入れ子になり、エスケープされた括弧（`\[` `\]`）はカウントに参加しません。`[[em:foo[[no-break:bar]]baz]]` では最初の `]]` が `no-break` を、次の `]]` が `em` を閉じます。
- **Ruby, tate-chu-yoko, and `《《...》》` content is plain text.** No MDI construct is recognized inside `{...|...}` (both base and reading), `^...^` (whose charset forbids it by construction), or `《《...》》`.
**ルビ・縦中横・`《《...》》` の内容はプレーンテキストです。** `{...|...}`（親文字・ルビとも）、`^...^`（文字種制限により構造上不可能）、`《《...》》` の内部では MDI 構文を認識しません。
- **Rendering nests naturally.** HTML output nests the corresponding elements (e.g. `…`). When boten wraps ruby, the stylesheet must suppress emphasis marks on the reading:
**描画は自然に入れ子になります。** HTML 出力は対応する要素をそのまま入れ子にします。傍点がルビを包む場合、ルビ文字（`