fd128abd13da30988776663eac3cf557468c80f0
Map USTC compiler phases onto lex/parse/sema plus tree-walk then bytecode, targeting marqdo run on index.mq.md rather than a native backend. Co-authored-by: Cursor <cursoragent@cursor.com>
Marqdo
代码即文档。文档即代码。
Marqdo:Markdown 标记即语法。源文件 .mq.md 既是文稿也是程序。
语法宪法:doc/design/markdown-mapping.md · 示例:examples/
语法速览(v0.1)
| 标记 | 含义 |
|---|---|
| 无标记行 | 注释 |
*…* |
程序语句 |
**…** |
返回值(架构) |
> 输出 … 等 |
输出等副作用 = 普通函数,非架构标记 |
# / ## |
函数与作用域 |
+ / 1. |
分支(臂头单独 * = else) |
- |
循环(头下纯名则为形参) |
| 表格 | 集合 |
--- / *** |
可选:框住分支/循环(不强制) |
# main
> 输出 内容=Hello World!
## 加一
- n
**`n` + 1**
理念
- 叙述默认安全(无标记 = 注释)。
- 返回是架构;打印只是函数。
- 依赖清单由工具生成(OKF 风格),不是手填配置。
- 正经解释器:词法/行分类 → 语法 → 语义 → 树遍历(再字节码);见 路线图。实现语言 Python(ADR 0001)。
现状
- 映射 v0.1:markdown-mapping.md
- 解释器路线图:interpreter.md
- 选型:ADR 0001 Accepted — Python
- Spike 存档:spike/REPORT.md
下一步:按路线图 M0 起建正式包,目标 marqdo run index.mq.md。
命名
Marqdo = Marq(Markdown)+ do(执行)
许可
Languages
Rust
82.1%
Go
12.7%
JavaScript
2.5%
Python
1.3%
CSS
0.5%
Other
0.8%