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

35 lines
933 B
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 可执行面与叙述面
| | |
|---|---|
| 状态 | 与 mapping v0.1 对齐 |
| 日期 | 2026-08-04 |
---
## 三层
| 层 | 形态 | 角色 |
|----|------|------|
| **叙述面** | 无标记行 | 注释;内部标记无语义 |
| **Marqdo 可执行面** | 结构标记 + `*语句*` + `**返回**` | 本语言程序 |
| **外联面** | ` ```lang ` | 其它语言(FFI) |
输出属于可执行面里的**函数调用**(如 `> 输出`),不是单独一类标记架构。
---
## 为何无标记不是「默认代码」
中文说明必须能直接写。可执行内容进入 `*` / `**` / `#` / `>` / `+` / `-` / 表等。详见 [markdown-mapping.md](markdown-mapping.md)。
---
## 语句 vs 返回 vs 输出
| 标记/形式 | 角色 | 是否架构级 |
|-----------|------|------------|
| `*…*` | 程序语句 | 是 |
| `**…**` | 返回值 | 是 |
| `> 输出 …` | 打印等副作用 | 否(普通函数) |