Files
marqdo/doc/design/code-vs-comment.md
T
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

1.7 KiB
Executable File
Raw Permalink Blame History

可执行面与叙述面

状态 与 mapping v0.3 对齐(现行运行时)
日期 2026-09-14
取代 本文曾按 v0.2(*语句* / **返回**)叙述;旧对照见 markdown-mapping.md
相关 markdown-mapping-v0.3.md §4

「Markup」在此仓库 = Marqdo 把 Markdown 标记映射成语法 的那一层,不是另一个语言。


三层

层 形态 角色
叙述面 普通段落 注释;行内 `名` 可声明/引用;装饰性 **强调** / *斜体* 不执行
Marqdo 可执行面 结构标记 + **代码** + *返回* 本语言程序
外联面 ```lang 其它语言(FFI)

输出属于可执行面里的函数调用(> print … / **print …**),见 keywords.md。

成段注释

  • 以空行划分段落。
  • 段首行:首字符非标记 → 注释段;段内续行一律叙述(即使以 ` / - 开头)。
  • 段内仍扫描行内可执行位:`名`、代码形 **…**、返回形 *…*。
  • 叙述段与独立结构行(> #)之间建议空一行,否则 > print 可能被吞进注释段。

语句 vs 返回 vs 输出

标记/形式 角色 是否架构级
**…** 代码(赋值 / 调用 / 表达式语句) 是
*…* 返回值(整行、返回*n*、或表达式形) 是
**** / 整行 ** / *None* 空返回 + 结束函数体 是
> print … 打印副作用 否(内置函数)
函数体 --- / *** 叙述分隔(跳过,不结束函数体) 否