1ae2ae0be86689c98423d58e4012c1280bddca55
Interpreters need lex/parse phases via hand-written descent plus a GFM crate; record the Cargo toolchain and reject C generator frontends for Marqdo. 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 风格),不是手填配置。
- 正经解释器(Rust):词法/行分类 → 递归下降语法 → 语义 → 树遍历 → 日后字节码;不用 Flex/Bison。见 路线图 与 依赖说明。
现状
- 映射 v0.1:markdown-mapping.md
- 解释器路线图:interpreter.md
- 依赖(Rust,无 Flex/Bison):dependencies.md
- 选型:ADR 0001 — Rust
下一步:Cargo 工程 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%