Files
marqdo/doc/design/code-vs-comment.md
cflmyandCursor 7554e45f60 feat(debug): dump v0.3 prose bits, inferred params, and dead binds
--dump-lines tags [decl]/[bold]/[italic]; --dump-ast prints `inferred` params
and `dead=[…]`. Migrate leftover italic-assign unit fixtures to bold/return.

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-09-14 15:33:45 +08:00

1.7 KiB
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 … 打印副作用 否(内置函数)
函数体 --- / *** 叙述分隔(跳过,不结束函数体) 否