- 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。
42 lines
1.7 KiB
Markdown
Executable File
42 lines
1.7 KiB
Markdown
Executable File
# 可执行面与叙述面
|
||
|
||
| | |
|
||
|---|---|
|
||
| 状态 | 与 mapping **v0.3** 对齐(现行运行时) |
|
||
| 日期 | 2026-09-14 |
|
||
| 取代 | 本文曾按 v0.2(`*语句*` / `**返回**`)叙述;旧对照见 [markdown-mapping.md](markdown-mapping.md) |
|
||
| 相关 | [markdown-mapping-v0.3.md](markdown-mapping-v0.3.md) §4 |
|
||
|
||
「Markup」在此仓库 = Marqdo **把 Markdown 标记映射成语法** 的那一层,不是另一个语言。
|
||
|
||
---
|
||
|
||
## 三层
|
||
|
||
| 层 | 形态 | 角色 |
|
||
|----|------|------|
|
||
| **叙述面** | 普通段落 | 注释;行内 `` `名` `` 可声明/引用;装饰性 `**强调**` / `*斜体*` 不执行 |
|
||
| **Marqdo 可执行面** | 结构标记 + **`**代码**`** + **`*返回*`** | 本语言程序 |
|
||
| **外联面** | ` ```lang ` | 其它语言(FFI) |
|
||
|
||
输出属于可执行面里的**函数调用**(`> print …` / `**print …**`),见 [keywords.md](keywords.md)。
|
||
|
||
### 成段注释
|
||
|
||
- 以**空行**划分段落。
|
||
- 段首行:首字符非标记 → 注释段;段内续行一律叙述(即使以 `` ` `` / `-` 开头)。
|
||
- 段内仍扫描行内可执行位:`` `名` ``、代码形 `**…**`、返回形 `*…*`。
|
||
- 叙述段与独立结构行(`>` `#`)之间**建议空一行**,否则 `> print` 可能被吞进注释段。
|
||
|
||
---
|
||
|
||
## 语句 vs 返回 vs 输出
|
||
|
||
| 标记/形式 | 角色 | 是否架构级 |
|
||
|-----------|------|------------|
|
||
| `**…**` | 代码(赋值 / 调用 / 表达式语句) | 是 |
|
||
| `*…*` | 返回值(整行、`返回*n*`、或表达式形) | 是 |
|
||
| `****` / 整行 `**` / `*None*` | 空返回 + 结束函数体 | 是 |
|
||
| `> print …` | 打印副作用 | 否(内置函数) |
|
||
| 函数体 `---` / `***` | 叙述分隔(跳过,**不**结束函数体) | 否 |
|