# 可执行面与叙述面 | | | |---|---| | 状态 | 与 mapping **v0.2** 对齐(成段注释);**v0.3 草案**见 [markdown-mapping-v0.3.md](markdown-mapping-v0.3.md) §4 | | 日期 | 2026-08-04 | | 修订 | 2026-09-13:注明 v0.3 叙述可含声明与行内代码段 | --- ## 三层 | 层 | 形态 | 角色 | |----|------|------| | **叙述面** | 成段注释(空行分段) | 注释;段内任意标记无语义 | | **Marqdo 可执行面** | 结构标记 + `*语句*` + `**返回**` | 本语言程序 | | **外联面** | ` ```lang ` | 其它语言(FFI) | 输出属于可执行面里的**函数调用**(`> print …`),见 [keywords.md](keywords.md)。 ### 成段注释 - 以**空行**划分段落。 - 段首行:首字符非标记 → 注释。 - 段内续行:一律注释(即使以 `` ` `` / `-` / `**` 等开头)。 - **例外**:整行仅为 `**expr**`(或 `****`)→ Marqdo **返回**;`**强调**` 后还有文字 → 仍是叙述注释。 - 叙述段与可执行代码之间**必须空一行**,否则 `> print` 等会被吞进注释段。 --- ## 语句 vs 返回 vs 输出 | 标记/形式 | 角色 | 是否架构级 | |-----------|------|------------| | `*…*` | 程序语句 | 是 | | `**…**` | 返回值 | 是 | | `****` / 空粗体 | 空返回 + 结束函数体 | 是 | | `> print …` | 打印副作用 | 否(内置函数) | | 函数体 `---` / `***` | 结束函数体 | 是(边界) | --- ## v0.3 草案预告(未实现) [mapping v0.3](markdown-mapping-v0.3.md) 拟改为: | 层 | 形态 | |----|------| | 叙述面 | 普通段落;`` `名` `` 可声明/引用 | | 可执行面 | 结构标记 + **`**代码**`** + **`*返回*`**;调用可无 `>` | | 外联面 | 不变 | 现行实现与上表(v0.2)一致,直至路线图默认切换。