┌─ Inline ──────────────────────────────────┐
│  $$bold(Hello $$italic(world)$$)$$        │
│                                           │
│  → 在文本流中开闭                           │
│  → 内容递归解析（嵌套标签会被识别）            │
│  → 最常用：粗体、斜体、链接                   │
│                                           │
│  简写（1.3）：$$bold(Hello italic(world))$$ │
│  → 需启用 implicitInlineShorthand          │
│  → 仅 `)` 关闭，无需 `$$` 包裹              │
└───────────────────────────────────────────┘

┌─ Raw ─────────────────────────────────────┐
│  $$code(typescript)%                      │
│  const x = 1;                             │
│  %end$$                                   │
│                                           │
│  → 内容不解析，原样保留                      │
│  → 关闭标记 %end$$ 必须独占一行              │
│  → 适合代码块、数学公式                      │
└───────────────────────────────────────────┘

┌─ Block ───────────────────────────────────┐
│  $$info(Note)*                            │
│  This is $$bold(important)$$ info.        │
│  *end$$                                   │
│                                           │
│  → 内容递归解析（和 inline 一样）             │
│  → 关闭标记 *end$$ 必须独占一行              │
│  → 适合提示框、警告栏、折叠区块               │
└───────────────────────────────────────────┘

✅ bold  myTag  h1  code_block  custom-tag
❌ 1tag  -tag

$$tagName(content)$$

$$bold(Hello $$italic(beautiful)$$ world)$$

$$bold(Hello italic(world))$$

$$bold(Hello $$italic(world)$$)$$

$$bold(bold(hi)$$)$$
                ^
简写 bold( 的 ) 恰好是 )$$ 的一部分
→ 如果简写抢走 )，)$$ 被拆开，外层 $$bold(...) 永远关不上
→ 判优：)$$ 完整命中，简写让步，整段 bold(hi 降级为文本
→ 外层 $$bold(...) 正常关闭 ✅

$$bold(bold(hi)$$)$$

$$bold(   → push bold (wants )$$)
bold(     → push shorthand (wants ))
hi        → text
)$$       → shorthand 想要 )，但 )$$ 完整命中
           → 让步，"bold(" 降级为文本，bold 从 argStartI 重扫
hi        → text（bold 重扫）
)$$       → bold 关闭 ✓（同一个 )$$）
)$$       → 孤立关闭标记，纯文本

$$bold(bold(hi $$italic(world)$$))$$

$$bold(     → push bold (wants )$$)
bold(       → push shorthand (wants ))
hi          → text
$$italic(   → push italic (wants )$$)
world       → text
)$$         → italic 关闭 ✓
)           → shorthand 想要 )，后面是 )$$ 不是 $$
             → 当前位置 ) 不构成 )$$ → shorthand 正常关闭 ✓
)$$         → bold 关闭 ✓

$$bold(bold(hi $$italic(world)$$)$$

$$bold(     → push bold (wants )$$)
bold(       → push shorthand (wants ))
hi          → text
$$italic(   → push italic (wants )$$)
world       → text
)$$         → italic 关闭 ✓
)$$         → shorthand 想要 )，但 )$$ 完整命中
             → 让步，"bold(" 降级为文本，bold 从 argStartI 重扫
hi          → text（bold 重扫）
$$italic(   → push italic (wants )$$)（bold 重扫识别到同一段）
world       → text
)$$         → italic 关闭 ✓（第一个 )$$）
)$$         → bold 关闭 ✓（第二个 )$$）

$$bold(a(b(c)))$$

$$bold(   → push bold (wants )$$)
a(        → push shorthand a (wants ))
b(        → push shorthand b (wants ))
c         → text
)         → b 关闭 ✓（后面是 ))$$，不构成 )$$）
)         → a 关闭 ✓（后面仍是 ))$$，不构成 )$$）
)$$       → bold 关闭 ✓

$$tagName(arg)%
raw content — 不会被解析
就算写 $$fake(tags)$$ 也原样保留
%end$$

$$code(typescript)%
function greet(name: string) {
    return `Hello, ${name}!`;
}
%end$$

$$tagName(arg)*
内容会递归解析——可以在里面用其他标签
*end$$

$$info(Note)*
This is $$bold(important)$$ information.
*end$$

$$link(Click here | https://example.com)$$
$$link(Click here | https://example.com | _blank)$$

$$code(typescript | line-numbers)%
const x = 1;
%end$$

$$tag(a\|b | c)$$
→ 两个参数：  "a|b" 和 "c"

$$bold(bold(hi)$$)$$

// handler 只声明了 raw
code: { raw: (arg, content) => ... }

// 用户写了 inline 形式 → 降级为纯文本
$$code(hello world)$$
→ 输出纯文本: "$$code(hello world)$$"

                    ┌── 必须先通过 supportsInlineForm ──┐
                    │                                    │
$$bold( ... $$code(arg)%...%end$$ ... )$$
              │                                    
              └── code 只有 raw，没有 inline            
                  → 进不了子帧 → 整段 $$code(...)%...%end$$ 变纯文本

// depthLimit: 3 时
$$a($$b($$c($$d(too deep)$$)$$)$$)$$
                 ^^^^^^^^^^^^^^^^
                 这段降级为纯文本 "$$d(too deep)$$"

$$bold(Hello $$italic(world)$$)$$
→ 正常解析 ✅

$$bold(Hello $$italic(world)$$ )$$
                               ^ 多了空格但括号配平 → 正常 ✅

$$bold(some text with ( inside)$$
                       ^ 裸括号 → 强制 inline fallback → bold 仍然正确关闭 ✅

$$bold(never closed
→ 纯文本: "$$bold(never closed"
→ 错误: INLINE_NOT_CLOSED

$$code(ts)%
const x = 1;  %end$$     ← 不在行首
%end$$                     ← 这才对

Hello )$$ world
→ 纯文本: "Hello )$$ world"
→ 错误: UNEXPECTED_CLOSE