Document line-scan for +/- bullets and hybrid frontmatter imports; defer choosing the full reference-implementation language. Co-authored-by: Cursor <cursoragent@cursor.com>
1.3 KiB
1.3 KiB
Spike 报告:Python + markdown-it-py(S1–S5)
| 日期 | 2026-08-04 |
| 状态 | 通过 |
| 命令 | cd spike && pytest -q → 6 passed |
结果
| ID | 项 | 结果 | 备注 |
|---|---|---|---|
| S1 | * vs ** |
通过 | em_* / strong_* 在 inline children 中 |
| S2 | - vs + |
通过 | 行扫描 scan_bullets 保留项目符;库只保证有 bullet_list |
| S3 | 单列表格 | 通过 | table 规则开启后可解析 |
| S4 | FM --- vs 正文 --- |
通过 | 自研 split_front_matter |
| S5 | FM 内 > *.mq.md |
通过 | 行正则抽取,不整块丢给严格 YAML |
对实现的含义
- 行扫描是必需层:
-/+消歧、frontmatter 导入、注释行分类,不宜只靠 MD 库 AST。 - markdown-it-py 足够做块/inline 结构(标题、表、强调、列表);避免
gfm-like默认linkify(缺可选依赖会炸)。 - Spike 不等于选定长期实现语言;仅证明 Python 路径可验证宪法。参考实现可继续 Python,或再评 TS/Rust。
建议下一步
- 将 ADR 0001 中 Spike 标为通过。
- 拍板:参考实现是否 继续 Python(推荐,与 Spike 同栈)或换栈。
- 再搭建正式包(
src/marqdo)与marqdo run,按 examples 金样例推进。