Clarify comment vs executable surfaces, make ---/*** optional control-flow frames, and keep implementation language undecided pending spikes. Co-authored-by: Cursor <cursoragent@cursor.com>
35 lines
933 B
Markdown
35 lines
933 B
Markdown
# 可执行面与叙述面
|
||
|
||
| | |
|
||
|---|---|
|
||
| 状态 | 与 mapping v0.1 对齐 |
|
||
| 日期 | 2026-08-04 |
|
||
|
||
---
|
||
|
||
## 三层
|
||
|
||
| 层 | 形态 | 角色 |
|
||
|----|------|------|
|
||
| **叙述面** | 无标记行 | 注释;内部标记无语义 |
|
||
| **Marqdo 可执行面** | 结构标记 + `*语句*` + `**返回**` | 本语言程序 |
|
||
| **外联面** | ` ```lang ` | 其它语言(FFI) |
|
||
|
||
输出属于可执行面里的**函数调用**(如 `> 输出`),不是单独一类标记架构。
|
||
|
||
---
|
||
|
||
## 为何无标记不是「默认代码」
|
||
|
||
中文说明必须能直接写。可执行内容进入 `*` / `**` / `#` / `>` / `+` / `-` / 表等。详见 [markdown-mapping.md](markdown-mapping.md)。
|
||
|
||
---
|
||
|
||
## 语句 vs 返回 vs 输出
|
||
|
||
| 标记/形式 | 角色 | 是否架构级 |
|
||
|-----------|------|------------|
|
||
| `*…*` | 程序语句 | 是 |
|
||
| `**…**` | 返回值 | 是 |
|
||
| `> 输出 …` | 打印等副作用 | 否(普通函数) |
|