Files
marqdo/doc/design/code-vs-comment.md
T
cflmyandCursor 0ae5bce70a Revise v0.1: italic statements, bold returns, output as a function.
Clarify comment vs executable surfaces, make ---/*** optional control-flow frames, and keep implementation language undecided pending spikes.

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-08-04 10:55:09 +08:00

933 B
Raw Blame History

可执行面与叙述面

状态 与 mapping v0.1 对齐
日期 2026-08-04

三层

层 形态 角色
叙述面 无标记行 注释;内部标记无语义
Marqdo 可执行面 结构标记 + *语句* + **返回** 本语言程序
外联面 ```lang 其它语言(FFI)

输出属于可执行面里的函数调用(如 > 输出),不是单独一类标记架构。


为何无标记不是「默认代码」

中文说明必须能直接写。可执行内容进入 * / ** / # / > / + / - / 表等。详见 markdown-mapping.md。


语句 vs 返回 vs 输出

标记/形式 角色 是否架构级
*…* 程序语句 是
**…** 返回值 是
> 输出 … 打印等副作用 否(普通函数)