Files
marqdo/doc
cflmyandCursor 2cb05fd838 Add v0 markup-as-syntax constitution, examples, and tech stack choice.
Lock Markdown marker mappings, ship runnable-shaped examples, and select TypeScript + remark + Vitest for the reference implementation.

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-08-04 10:42:36 +08:00
..

Marqdo 开发文档

本目录存放各阶段设计与调研文档。

目录约定

路径 用途
research/ 外部标准与调研
design/ 语言设计(语法映射、清单模型等)
adr/ 架构决策记录(待建)
roadmap/ 里程碑(待建)

当前文档

文档 摘要
design/markdown-mapping.md v0 语法宪法:Markup-as-Syntax 全映射
design/generated-yaml-manifest.md 机器生成的 OKF 风格依赖/文档清单
design/tech-stack.md 参考实现技术选型(TypeScript + remark + Vitest)
research/okf-and-marqdo.md Google OKF 调研与借鉴

示例程序见仓库 examples/。

写作原则

  1. 先思想,后实现。
  2. 草案可演进;否决项进 ADR。
  3. 示例统一 .mq.md。