Make prose-unified Markup the only runtime: bold segments are executable, italic is return, params can be inferred from body/prose, with no v0.2 dual mode. Migrate lib and structure/keywords golds; gate on tests/markup-v03. Co-authored-by: Cursor <cursoragent@cursor.com>
1.8 KiB
1.8 KiB
可执行面与叙述面
| 状态 | 与 mapping v0.2 对齐(成段注释);v0.3 草案见 markdown-mapping-v0.3.md §4 |
| 日期 | 2026-08-04 |
| 修订 | 2026-09-13:注明 v0.3 叙述可含声明与行内代码段 |
三层
| 层 | 形态 | 角色 |
|---|---|---|
| 叙述面 | 成段注释(空行分段) | 注释;段内任意标记无语义 |
| Marqdo 可执行面 | 结构标记 + *语句* + **返回** |
本语言程序 |
| 外联面 | ```lang |
其它语言(FFI) |
输出属于可执行面里的函数调用(> print …),见 keywords.md。
成段注释
- 以空行划分段落。
- 段首行:首字符非标记 → 注释。
- 段内续行:一律注释(即使以
`/-/**等开头)。 - 例外:整行仅为
**expr**(或****)→ Marqdo 返回;**强调**后还有文字 → 仍是叙述注释。 - 叙述段与可执行代码之间必须空一行,否则
> print等会被吞进注释段。
语句 vs 返回 vs 输出
| 标记/形式 | 角色 | 是否架构级 |
|---|---|---|
*…* |
程序语句 | 是 |
**…** |
返回值 | 是 |
**** / 空粗体 |
空返回 + 结束函数体 | 是 |
> print … |
打印副作用 | 否(内置函数) |
函数体 --- / *** |
结束函数体 | 是(边界) |
v0.3 草案预告(未实现)
mapping v0.3 拟改为:
| 层 | 形态 |
|---|---|
| 叙述面 | 普通段落;`名` 可声明/引用 |
| 可执行面 | 结构标记 + **代码** + *返回*;调用可无 > |
| 外联面 | 不变 |
现行实现与上表(v0.2)一致,直至路线图默认切换。