Files
marqdo/doc/design/markdown-mapping-v0.3.md
cflmy 9331af78e2 release(2.8.0): 合入 CHANGELOG/README/发版说明/skills prove 任务;CI 链接指向 doc/releases
- CHANGELOG.md:v2.8.0 条目(中英双语);
- README.md:版本行 2.7.1→2.8.0 + 愿景第 6 条(知识可证明);
- doc/releases/v2.8.0.md:双语发版说明(亮点/用法/已知限制);
- skills/marqdo-dev/index.mq.md:新增 prove 任务(路径/目录模式/
  require_lean/json;参数用 + 行声明升参,check 与 narrative-ratio 通过);
- 设计文档 §12.5 标记已合入;发版链接统一指向 doc/releases/v2.8.0.md。
2026-11-18 10:29:26 +08:00

26 KiB
Executable File
Raw Permalink Blame History

Marqdo 语法映射 v0.3(叙述统一 · 粗体即代码)

状态 Accepted · 现行运行时目标(实现中)
日期 2026-09-13
取代 markdown-mapping.md v0.2(已废止为运行时宪法)
ADR 0005-prose-unified-markup.md
路线 markup-v0.3.md
相关 code-vs-comment.md · return-hr-and-code-surface.md · call-arguments.md · objects.md · keywords.md

名词: 本文「Markup」指 Marqdo 如何把 Markdown 标记映射成语法(** 代码、* 返回、`名` 声明),不是另一个语言。产品仍是 Marqdo。
v0.3 为唯一映射。 不做 v0.2 双模式 / --markup 版本身份。摸索阶段允许破坏性变更;旧 .mq.md(*语句* / **返回**)须改写。金样例见 tests/markup-v03/。


0. 一句话

让 Markdown 叙述本身成为程序的一部分:普通文字里用 `名` 出现变量(首次未赋值 = 声明);用 **…** 粗体 包裹可执行代码(含调用,不必再写 >);用 *…* 斜体 表示返回值。函数形参不再手写 + 列表,由函数体内的声明/赋值自行推断。


1. 动机(为何推翻 v0.2 的部分定论)

v0.2 为了「标记即语法」的清晰边界,做了这些硬隔离:

v0.2 代价
无标记行 = 纯注释;变量只能写在 *…* / 结构行里 叙述与代码割裂,「文档即代码」读起来像两套语言叠在一起
*…* = 语句,**…** = 返回 与常见 Markdown/AI 习惯相反:模型更爱用 ** 强调「要执行的东西」,读者也更易看见粗体
调用必须 > 行间调用要另起结构行,叙述中夹调用不自然
形参必须 + `名` 仪式感强;函数头像「另一套签名语言」,与正文脱节

古早示例(当时不能跑,正是本文要合法化的目标面):

## 加一函数

对于输入变量`n`,我们执行操作**n=n+1**接着返回*n*。

# main

我要调用加一函数可以采用这样的办法:

> 加一函数 37

或者可以直接这么调用**加一函数 37**

目标:上述文件在 v0.3 下应能解析、求值,且读起来仍是一篇正常中文说明。


2. 哲学(设计原则)

P1 — 叙述统一(Prose-unified)

  • Marqdo 注释采用 Markdown 叙述(段落、列表中的说明文字),不是第二种注释语法。
  • 变量可以出现在正常文字之间:用 Markdown 行内代码 `n` 标识标识符。
  • 第一次出现且未赋值 = 声明变量;之后的出现 = 引用。赋值发生在粗体代码段内(或兼容的结构赋值形)。
  • 未使用的变量无害(不报错、不升参);真正的输入由「可执行面读取」升为形参(§8)。
  • 这样「说明文字」与「程序名字」共用同一套 Markdown 视觉习惯,整体更和谐。

P2 — 粗体即代码(Bold-as-code)

  • **…** = 代码段(可执行):赋值、表达式、函数/方法调用、可内联的短语句。
  • 选择粗体的原因:
    1. AI 输出偏好:模型天然爱用 ** 强调「重要操作」;把粗体定为可执行,降低「模型写了强调却被当成返回」的错配。
    2. 行间显眼:在长段落里,粗体比斜体更容易被扫到。
  • 粗体代码段内的调用 允许不写 >:**加一函数 37** 与 > 加一函数 37 语义等价(见 §6)。
  • > 保留为可选调用面(blockquote 风格、独立行、兼容 v0.2 迁移与 AI 已学会的形态)。

P3 — 斜体即返回(Italic-as-return)

  • *…* = 返回值(架构级),与粗体代码形成对立、易读的一对:
    • 做了什么 → 粗体
    • 结果是什么 → 斜体
  • 空返回 / 无值收束(已决议,见 §7.2):推荐 *None* / *无*;整行 **;兼容 ****。--- / *** 仅为叙述分隔(跳过),不再结束函数体。
  • 输出仍不是返回:打印继续用内置 print / 打印(副作用函数),不把粗体或斜体当成「打印到终端」的语法。

P4 — 形参由体推断(Body-inferred params)

  • 不再要求作者手写 + `名` 形参表(v0.3 默认关闭;过渡期可兼容,见 §8)。
  • 函数体内:
    • 只声明、未赋默认 → 必选形参(调用时必须提供)。
    • 声明同时赋值(含默认值字面量)→ 可选形参(带默认值)。
  • 推断顺序与绑定规则见 §8;与位置/具名实参规则对齐 call-arguments.md 的精神(可修订附录)。

P5 — 标记仍承载控制流(不变)

  • 不引入 if / else / while / for / def / return 关键字。
  • # = 对象/类型,##+ = 函数/方法(objects.md 不变)。
  • 分支仍用 1. 2. …;循环仍用 -;结构行不必再包粗体(见 §5)。

P6 — 其它「代码即文档」补强(本版一并采纳)

思路 说明
渐进披露 读者可只读叙述;运行时只执行标记与推断出的声明。同一文件服务人与机器。
最小仪式 能从正文看出的签名,就不在函数头重复写一遍。
双调用面 独立行 > 适合「步骤清单」;行间 **f …** 适合「嵌在句子里的动作」。
标识符视觉统一 叙述、代码、形参一律优先 `名`;粗体/斜体内部允许裸名(与 v0.2 斜体/粗体内规则同类)。
段落仍可整段注释 不含任何可执行标记、且无「声明性 `名`」义务的纯说明段,行为与注释相同(见 §4 消歧)。
迁移可观测 --dump-lines / --dump-ast 必须能区分「叙述中的声明」与「粗体代码」与「斜体返回」。

3. 与 v0.2 对照(角色对调摘要)

概念 v0.2 v0.3
程序语句 / 代码段 *…* **…**
返回值 **…** *…*
独立调用 必须 > > 或 **callee …**
形参 标题下 + `名` 体推断(+ 过渡兼容)
叙述中的变量 一般为注释,不可声明 `名` 可声明/引用
无标记纯文字 成段注释 仍为叙述;若含声明性反引号则参与绑定图(见 §4)

这是一次 架构级标记对调,不是局部糖。金样例、教程、Skill、扩展库需按路线图分波迁移。


4. 叙述、声明与注释

4.1 三层模型(修订)

层 形态 角色
叙述面 普通 Markdown 段落、列表说明 给人读;其中的 `名` 可进入绑定图
可执行面 结构标记(# > + - 1. 表…)+ **代码** + *返回* 求值
外联面 ```lang FFI(不变)

4.2 变量在叙述中的出现

语法:Markdown 行内代码 `标识符`。

出现形态 语义
全文(当前函数/对象作用域)首次出现 `n`,且此前/同句无对 n 的赋值 声明变量(进入绑定图;是否升为形参见 §8)
已声明之后再次 `n` 引用(不生成新绑定)
粗体内 **n = …** / **n=n+1** 赋值(若首次赋值且未见声明,则声明+赋值一并发生)
叙述中 `n`=1(反引号名紧贴 =,无粗体) 带初值的声明(形参默认或局部初值;见 §8)

推荐作者写法(与动机示例一致):

对于输入变量`n`,我们执行操作**n=n+1**接着返回*n*。
  • `n` → 声明变量;因随后在代码中读取未先由局部独力定义 → 升为必选形参(§8)
  • **n=n+1** → 代码段(赋值)
  • *n* → 返回

4.3 何为「纯注释」

满足下列全部条件的段落,不产生绑定、不求值:

  1. 不含结构标记行;
  2. 不含 **…** / 作为返回的 *…*(见 §7);
  3. 不含任何 `标识符`。

仍建议:叙述段与独立结构代码行之间空一行,降低人读与差分时的视觉粘连(解析器在 v0.3 下不再依赖「空行分段注释升级」作为唯一边界,但空行仍是作者卫生习惯)。

4.4 提及性反引号:一律视作变量(已决议)

不另设「仅提及、不声明」语法。 叙述里凡出现合法标识符 code span `名`,一律按 变量 处理(首次 = 声明,其后 = 引用)。

情况 处理
谈到某名但可执行代码从未读写它 仍是绑定图中的变量;对求值无影响(死绑定)
与其它语言对照 类似 Python 写了未用局部、JS 未用 let——默认可忽略;实现可对「从未读写」发可选 lint,不得因此报错或拒绝运行
是否变成函数形参 否(仅声明、从未在可执行面被读取)——见 §8.2「升参条件」
是否需要 提及`n` 等前缀 不需要;避免第二套反引号方言

例(合法、无副作用):

## 说明性函数

本文顺便提到`Markdown`与`GFM`,但真正的输入只有`题干`。
**print text=题干**
---
  • `Markdown` / `GFM` → 变量声明,未使用 → 不进形参表、不改行为
  • `题干` → 声明且在粗体中读取 → 必选形参

否决:为「提及」单独做转义/前缀(曾列于开放点);若将来作者强烈需要「叙述中的等宽字但不进绑定图」,另开增强案,不阻塞 v0.3 核心。

4.5 成段规则相对 v0.2 的变化

v0.2:「段首无标记 → 整段注释,续行永不升级」。
v0.3:

  • 叙述段落可以内含可执行粗体/斜体返回;解析器做段内扫描,抽出 `名`、**…**、*…*。
  • 独立结构行(行首 # > - 1. | 等)仍整行分类为代码。
  • 否决维持:「整行无标记 = 默认可执行代码」。无标记且无反引号声明的文字永不单独变成语句。

5. 映射总表(v0.3)

标记 语义
# … ###### # = 对象/类型;##+ = 函数/方法(同 objects.md)
叙述中 `名` 声明或引用(§4)
**…** 代码段(赋值、表达式、调用)
*…* 返回值(含显式空值,见 §7.2)
> 行 调用(可选面,与粗体内调用等价)
+ `名` 过渡兼容:显式形参;新代码不推荐
体内 1. 2. … 分支
体内 - 循环
N. * else 臂(此处 * 仍是「空条件」标记,不是返回值;见 §7.3)
GFM 表格 集合;`名` = 后绑定,或未绑定时求值后丢弃(文档中可写表)
表达式 [键](集合) 取元(与 foreach 同形;见 collection-access-link.md)
修饰… [函数名] 实参… 方括号标记调用(前置修饰 → 名=True;见 bracket-call-modifiers.md)
集合[^键] 过渡:旧脚注取元(仍可用)
```lang 外联(不变;绑定仍用 `名` = + 围栏)
$$ 内 % marqdo: var=名 块公式绑定(fence-meta-and-control-prose.md)
- 对集的每一项项`` / for each foreach 叙述糖;推荐 - [项](集)
单独一行 --- / *** 叙述分隔(跳过;模块顶与函数体内相同)
整行恰 ** 或 **** / *None* / *无* 空返回并结束本函数体(见 §7.2)

结构行与粗体

行首已是结构标记的构造(# > + - |、1.)不必再包 **…**。
粗体用于:嵌在叙述中的代码,以及「我想把这一小段标成可执行」的行间片段。


6. 调用

6.1 调用表面

> 加一函数 37

**加一函数 37**

礼貌 [问候] marqdo

前两种解析为对 加一函数 的调用;第三种为方括号标记调用([ ] 标出函数名,前置裸词展开为 名=True)。实参位置或具名绑定;详见 call-arguments.md · bracket-call-modifiers.md。

形式 典型用途
> … 步骤列表、独立可执行行、与 v0.2/AI 习惯兼容
**…** 嵌在句子中:「或者可以直接这么调用加一函数 37」
**x = 加一 37** 粗体赋值右侧为调用时可省略 >(代码即文档首选;> 加一 37 仍合法)
修饰… [函数] 实参… 叙述里需要「形容词 + 动词」时消歧;与 [键](集合) 取元靠 ] 后是否紧邻 ( 区分

6.2 粗体内调用的判别

粗体内容在去掉外层 ** 后,按下列优先级分类:

  1. 含 = 且左侧为可赋值目标(标识符 / 脚注左值等)→ 赋值语句(可含右侧调用)。
  2. 否则,若首词为已知函数/方法/内置/导入成员(Pass 名表可见)→ 调用。
  3. 否则 → 表达式语句(求值后丢弃,或在语句位置非法则诊断)。

示例:

粗体内容 分类
n=n+1 赋值
加一函数 37 调用
加一函数 n=37 调用(具名)
n + 1 表达式(单独出现时;作返回应写 *n + 1*)
print text=hi / 打印 内容=你好 调用(内置)

6.3 方法调用

  • 独立行:> `对象`.方法 …(兼容)或 > 对象.方法 …(若接收者规则允许)。
  • 粗体内:**对象.方法 …** / **p = page.主体装配 组件=home**。
  • 粗体/斜体内裸名 = 变量(延续 v0.2「段内统一命名空间」精神)。

6.4 实参

具名 + 位置混用规则继承 call-arguments.md;v0.3 仅把「形参列表来源」从 + 行改为推断签名(§8)。独立 > 行上裸词仍为文本字面量;粗体内调用的裸词为变量(与 v0.2「段内调用」一致)。


7. 返回

7.1 斜体返回

*n*
*n + 1*
*"ok"*

斜体内部值语法与 v0.2 粗体返回内部相同(裸词 = 变量;文本须引号)。

7.2 空返回与收束(已决议)

Marqdo 不引入 return 关键字;「无值结束」用标记表达。对照常见语言:

语言 无值 / 空返回 Marqdo v0.3 对应
Python return / return None 显式 *None*·*无*
Go 无结果函数里的 return *None* / 整行 ** / ****
Rust () 或函数末尾隐式 unit 同上;或下一标题 / EOF 自然结束
JavaScript return; → undefined 同上 → 运行时 None
Marqdo 历史 --- 收束;**** --- 已改为叙述跳过;**** 仍兼容

形式层级(推荐自上而下)

优先级 形式 语义 说明
1. 显式空值 *None* 或 *无*(整段或行内返回位) 返回 None 并结束本函数体解析 对齐 Python return None;副作用函数首选;外层续写依赖此收束
2. 空斜体标记 整行 trim 后恰为两个星号:** 同上 词法钉死:^\s*\*\*\s*$ → 空斜体返回,不得当成粗体开闭
3. 兼容 整行 ****(四个星号) 同空返回 迁移期识别
(非收束) 整行 --- / *** 仅叙述分隔,跳过 不再结束函数;见 code-as-docs-gaps.md
## 只打印
**print text=hi**
*None*

## 空斜体行
**print text=hi**
**

## 分割线不收束(下一标题才结束)
**print text=hi**
---

词法消歧(空斜体 vs 粗体)

  1. 整行恰好 **(两个 *) → 空返回(规则 2),不是未闭合粗体。
  2. 粗体代码至少包住一个非空内容:**x**、**n=1**;不允许「空粗体代码段」作为语句。
  3. 四个星号整行 **** → 兼容空返回(规则 3),不解释为「空粗体代码」。
  4. 行内出现的 **…**(两侧还有叙述文字)按正常粗体代码扫描,不走「整行空返回」。

与「有返回值」的关系

  • 需要把值交回调用方 → 用非空斜体:*n*、*n + 1*(返回即结束本函数体解析)。
  • 只做副作用、不要值 → 优先 *None* / *无* / 整行 **。
  • 下一标题或 EOF 也可结束体;不要再靠 --- 收束。

7.3 与 else 臂 N. * 的消歧

有序列表臂头 2. * 中的 * 表示 else,不是返回。判别:行匹配 ^\s*\d+\.\s+\*\s*$(可带尾注)→ 分支 else;不进入返回扫描。

7.4 输出

**print text=Hello**
> print text=Hello

打印是调用,不是返回。禁止把 *Hello* / **Hello** 解释为「打印 Hello」(延续 v0.2 决议精神,仅对调标记)。


8. 形参推断

8.1 目标签名

对每个 ## 函数(及方法),在 Pass1 收集体之后得到:

params: Vec<{ name, default: Option<Expr>, span }>

8.2 收集规则(函数作用域)

扫描该函数标题之下、下一同级/更高级标题之前的所有节点,维护绑定图与形参表(二者分离):

A. 绑定图(所有变量)

  1. 声明事件:叙述或代码中的首次 `名`,或粗体内首次对 名 的赋值左值。
  2. 默认/初值事件:叙述 `名`=默认表达式;或符合 §8.3 的「形参默认」赋值。
  3. 排除出绑定图(不建变量):
    • 循环变量 - [项](集合) 中的 项(循环自有绑定);
    • self / 自(方法自动注入)。

凡进入绑定图的名字都是变量——包括「只在叙述里出现、可执行代码从未读写」的名字(§4.4)。未使用 → 不报错。

B. 升为形参的条件(升参)

名字已在绑定图中,且满足下列之一,才进入 params:

升参种类 条件
必选形参 在可执行面(**…** / *…* / > / 结构语句)中存在对 名 的读取,且该读取无法单靠「不依赖外部输入的局部赋值」满足——典型:先声明、后 n=n+1 / *n* / **print text=n** 等读到未先行赋成纯局部常量
可选形参 有默认/初值事件(`名`=… 或 §8.3 默认赋值),供调用方覆盖

不升参:仅叙述声明、可执行面零读取(死绑定)→ 留在绑定图,不进 params,调用签名不变。

顺序:按升参名字的首次声明事件在源码中的出现序。

仍排除:分支/块内纯局部(金样例钉启发式);显式 + 合并见 §8.4。

8.3 「形参默认」与「函数体赋值」的区分

## 问候
对`谁`打招呼,默认`礼貌`=False。

**print text=谁**
  • `谁` → 必选
  • `礼貌`=False → 可选,默认 False
  • 体里的 **print …** 不是给 谁 赋默认值
## 加一函数
输入`n`。**n=n+1**返回*n*。
  • `n` 先声明 → 必选
  • **n=n+1** 是体语句(对已声明形参赋值),不是默认值

判别启发式(实现契约):

  • 若赋值右值依赖同名左值(如 n=n+1)→ 体语句。
  • 若赋值出现在「该名被当作输入读取」之前,且右值不依赖未绑定的同名 → 可作为默认值候选。
  • 叙述形 `名`=字面量 优先视为默认值声明。

8.4 显式 + 形参(过渡)

  • 若函数标题下仍有 + `名` 行:与推断结果合并;冲突时 显式 + 胜出并诊断警告。
  • 迁移完成后(路线图 M4)可改为:存在 + 则关闭推断,或直接废弃 +。

8.5 调用绑定

与现有一致:具名优先,位置按「尚未绑定的形参」从左到右填充。缺必选形参 → 语义错误。


9. 完整示例(规范金样意向)

9.1 加一(动机例)

## 加一函数

对于输入变量`n`,我们执行操作**n=n+1**接着返回*n*。

# main

我要调用加一函数可以采用这样的办法:

> 加一函数 37

或者可以直接这么调用**加一函数 37**

期望:

  • 签名:加一函数(n)
  • # main 两次调用均返回 38(第二次若未绑定到打印,至少 AST/求值结果为 38;可用 **print text=…** 观测)。

9.2 带默认值

## 问候

向`谁`问好;`礼貌`=False 时用短句。

1. 礼貌
    **print text=您好,**
    **print text=谁**
2. *
    **print text=嗨,**
    **print text=谁**

---

# main

**问候 谁=Marqdo 礼貌=True**
> 问候 Marqdo

9.3 对象方法(不变骨架)

# 计数器
    ## 加
        将`self`的`值`增加`delta`(`delta`=1)。
        **值 = 值 + delta**
        *self*

# main
*c = > 计数器*
**c.加 3**

(方法形参推断含 delta;self 自动。)


10. AST / 管线变更要点(设计约束)

详细里程碑见 markup-v0.3.md。此处只钉语义 → 树的约束,供实现对照:

10.1 行分类(lex / line-class)

新增或调整类别:

类别 说明
Prose 叙述行;需内联扫描
BoldCode 整行或片段 **…**
ItalicReturn 整行或片段 *…*(非 else 臂)
CallLine > 调用(保留)
… 原有 Heading / List / Table / Fence / Hr

内联扫描产出 InlineBit:Text | IdentDecl/Ref | BoldCode | ItalicReturn。

10.2 AST 节点调整(建议)

Param { name, default?, inferred: bool, span }  // inferred=true 表示来自体推断

Stmt::
  Assign { … }           // 多由 BoldCode 解析
  Call { … }             // CallLine 或 BoldCode 判别为调用
  Return { value }       // 由 ItalicReturn 解析(原由 Bold)
  ExprStmt { … }         // 可选:纯表达式粗体
  Prose { bits }         // 可选:保留叙述结构供 view/catalog;求值阶段只消费 Decl

FnDef.params:
  由 InferParams(body + prose bits) 填充,再合并显式 +

Stmt::Return 的语法来源从粗体改为斜体;dump 文本应写 return←italic。

10.3 Pass1 / Pass2

  • Pass1:收集 #/## 结构;建绑定图;跑 ParamInfer(升参);登记名表。
  • Pass2:粗体内调用名解析;叙述 Decl 不重复建参。
  • 诊断:必选缺失、+ 与推断冲突、空返回词法歧义(非整行 ** 的残缺粗体)。
  • Lint(可选、默认关或降级为 hint):绑定图中「从未读写」的死变量——不得当错误。

10.4 双后端

树遍历与字节码均消费同一 AST;字节码发射仅跟随 Stmt/Expr 变化,不感知 Markdown 标记。


11. 破坏性切换(无双模式)

产品决定(2026-09-13): 直接以 v0.3 为唯一运行时映射;不保留 --markup v0.2 / 双 edition。旧语法金样例与库文件在迁移完成前可能失败——可接受。

阶段 行为
现在 解析器切到 v0.3;tests/markup-v03/ 为门禁
随后 批量改写 `tests/structure
文档 markdown-mapping.md 改为指向本文;ADR 0005 → Accepted

机械改写:

  • 语句 *a = 1* → **a = 1**
  • 返回 **x** → *x*
  • 粗体内文本字面量须引号:**print text="hi"**(裸词 = 变量)
  • 调用可保留 > 或改为粗体
  • + `n` 可删,改为叙述 `n` + 升参

12. 开放问题 / 已决议

# 议题 状态 决议摘要
1 空返回词法 已决议 §7.2:推荐 *None*/*无*;整行 **;兼容 ****;--- 仅叙述跳过
2 提及性反引号 已决议 §4.4:一律视作变量;未使用不报错、不升参;不设提及前缀
3 粗体内调用 vs 赋值 已落地 §6.2:可赋值左值 → 赋值;否则表达式优先、再裸调用;**n + 1** = ExprStmt
4 `n`+1 误声明 已落地 Decl 名须为标识符;`n+1` 不升 Decl
5 叙述强调斜体 vs 返回 已落地 整行 / 返回*…* / 表达式形才当返回;*only* *very important* *foo.bar* 为叙述
6 一行多 **…** 已落地 允许,按出现序执行(tests/markup-v03/multi-bold.mq.md)
7 view 展示 prose Decl 已落地 Structure / Functions 大纲:inferred 形参标注(chip inferred)

13. 非目标

  • 不把整篇无标记 Markdown 变成可执行程序。
  • 不引入 def / return 关键字(空返回用标记,见 §7.2)。
  • 不改变 # / ## 对象体系与 ext 插件 ABI。
  • 不在本文阶段修改解释器代码(见路线图)。
  • 不为「提及」另发明一套反引号方言(§4.4)。

14. 验收标准(设计完成 ≠ 实现完成)

设计稿验收:

  • 哲学 P1–P6 成文
  • 与 v0.2 对照表
  • 形参推断规则可实现(含升参 vs 死绑定)
  • 动机示例在语义上闭合
  • AST/管线约束与路线图挂接
  • ADR 记录决策意向
  • 空返回对照其它语言并钉死词法
  • 提及/未使用变量政策钉死

实现验收:

  • 金样例夹具 tests/markup-v03/(gold.rs markup_v03_*)
  • 动机示例金样例通过(inc-prose.mq.md)
  • --dump-ast 可见 inferred params 与死绑定;--dump-lines 标注 [decl] / [bold] / [italic]
  • 空返回四种形式金样例通过
  • 无 v0.2 双模式(默认即 v0.3)

15. 修订历史

日期 说明
2026-09-13 初稿:叙述统一、粗体代码、斜体返回、形参体推断;Proposed
2026-09-13 决议空返回(§7.2)与提及性反引号(§4.4);形参改为「升参」与绑定图分离(§8.2)
2026-09-14 §7.2:--- 不再收束;返回语句结束函数体解析;空返回首选 *None*
2026-09-14 取元主语法改为 [键](集合);脚注取元过渡保留
2026-09-24 Artifact Metadata Binding(${…} Phase 1,仅 frontmatter):见 binding.md · ADR 0006