Files
marqdo/doc
cflmyandCursor 1ae2ae0be8 Switch reference impl to Rust and document deps without Flex/Bison.
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>
2026-08-04 11:13:23 +08:00
..

Marqdo 开发文档

本目录存放各阶段设计、选型与路线图。

目录约定

路径 用途
research/ 外部标准与调研
design/ 语言设计(语法映射等)
adr/ 架构决策记录
roadmap/ 实现路线与里程碑

当前文档

文档 摘要
design/markdown-mapping.md v0.1 语法宪法
design/code-vs-comment.md 叙述 / 可执行 / 外联
design/return-hr-and-code-surface.md 语句/返回/输出决议
design/generated-yaml-manifest.md 生成式 OKF 清单
design/tech-stack.md 实现栈对比
adr/0001-implementation-language.md Accepted:Rust 参考解释器;不用 Flex/Bison
design/dependencies.md 依赖详单:工具链、Cargo crate、为何不用 Flex/Bison
roadmap/interpreter.md 正经解释器路线图
research/okf-and-marqdo.md OKF 调研

示例与验收集:examples/。Spike 存档:spike/。

写作原则

  1. 先宪法与路线图,再实现。
  2. 金样例不过 = 未完成。
  3. 示例统一 .mq.md。