23fa4284a8cb4557e250a6c070615b2bb9985cc7
Document line-scan for +/- bullets and hybrid frontmatter imports; defer choosing the full reference-implementation language. 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 风格),不是手填配置。
- 实现语言未定案:见选型 ADR 0001(提议:验证期 TypeScript + remark)。
现状
- 映射 v0.1:markdown-mapping.md
- 选型 ADR(提议中):0001-implementation-language.md
- 选型分析:tech-stack.md
命名
Marqdo = Marq(Markdown)+ do(执行)
许可
Languages
Rust
82.1%
Go
12.7%
JavaScript
2.5%
Python
1.3%
CSS
0.5%
Other
0.8%