Files
marqdo/examples/code-as-docs/README.md
T
cflmyandCursor 4a1c9c48a2 feat(markup): prefer [key](collection) for map and list access
Add GFM link-shaped index as the primary get surface, keep footnote
index as transitional compatibility, and align the coffee example.

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-09-14 10:44:18 +08:00

23 lines
841 B
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 代码即文档 · 周末咖啡手账
可读可跑的 v0.3 样例:`.mq.md` 同时是说明文和程序。
```bash
marqdo run examples/code-as-docs/index.mq.md
```
## 这份样例在示范什么
| 习惯 | 写法 |
|------|------|
| 数据给人读 | GFM 表当菜单 / 订单 |
| 步骤嵌在句子里 | `**总额 = 价 * 杯数**`、返回 `*总额*` |
| 装饰性强调 | `**说明**` 不执行 |
| 段落分隔 | `---` 只是分割线 |
| 浮点 | `折扣`=0.85 |
| 取元 | `[拿铁](菜单)` / `` [`名`](菜单) ``(与循环同形;脚注 `[^…]` 仅过渡) |
| 循环 | `- [行](今日订单)` |
| 调用 | `**摘要 = 结账摘要 …**`(粗体 RHS 可省略 `>`) |
设计:[collection-access-link.md](../../doc/design/collection-access-link.md)、[code-as-docs-gaps.md](../../doc/design/code-as-docs-gaps.md)。