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>
This commit is contained in:
cflmyandCursor committed 2026-09-14 10:44:18 +08:00
1 parent 5e74ff39f2
commit 4a1c9c48a2
12 files changed
+235 -23

No files matched your search

+6 -5
View File
@@ -12,10 +12,11 @@ marqdo run examples/code-as-docs/index.mq.md
|------|------|
| 数据给人读 | GFM 表当菜单 / 订单 |
| 步骤嵌在句子里 | `**总额 = 价 * 杯数**`、返回 `*总额*` |
| 装饰性强调 | `**说明**` 不执行(见设计 G2) |
| 段落分隔 | 顶层或体内的 `---` 只是分割线 |
| 装饰性强调 | `**说明**` 不执行 |
| 段落分隔 | `---` 只是分割线 |
| 浮点 | `折扣`=0.85 |
| 动态键 | `` 菜单[^`名`] `` |
| 调用 | 粗体赋值右侧 **可省略 `>`**:`**摘要 = 结账摘要 …**`;输出可用 `**打印 内容=…**` |
| 取元 | `[拿铁](菜单)` / `` [`名`](菜单) ``(与循环同形;脚注 `[^…]` 仅过渡) |
| 循环 | `- [行](今日订单)` |
| 调用 | `**摘要 = 结账摘要 …**`(粗体 RHS 可省略 `>`) |
相关设计:[code-as-docs-gaps.md](../../doc/design/code-as-docs-gaps.md)、[markdown-mapping-v0.3.md](../../doc/design/markdown-mapping-v0.3.md) §6。
设计:[collection-access-link.md](../../doc/design/collection-access-link.md)、[code-as-docs-gaps.md](../../doc/design/code-as-docs-gaps.md)。
+9 -8
View File
@@ -2,7 +2,7 @@
title: 代码即文档 · 周末咖啡手账
description: >-
一份可读可跑的周末手账:菜单是表,计价写在段落里,主流程像日记。
展示叙述统一写法、装饰性强调、分隔线、浮点折扣、动态脚注键,以及粗体内免 `>` 的调用。
展示叙述统一写法、链接形取元 [键](集合)、浮点折扣,以及粗体内免 `>` 的调用。
---
本文件既是**说明**也是**程序**。人读得到段落与表格;机器执行嵌在叙述里的粗体步骤,并把斜体当作返回值。
@@ -53,20 +53,21 @@ description: >-
---
第一单:会员双杯拿铁。品名先记在变量里,再用动态键取价;粗体赋值右侧是调用时不必再写 `>`:
第一单:会员双杯拿铁。品名记在变量里,用链接形取元 `` [`名`](菜单) ``(与循环 `[项](集合)` 同形):
**名 = "拿铁"**
**摘要 = 结账摘要 品名=`名` 价=菜单[^`名`] 杯数=2 会员=True**
**价 = [`名`](菜单)**
**摘要 = 结账摘要 品名=`名` 价=`价` 杯数=2 会员=True**
**打印 内容=`摘要`**
对照一单非会员美式——品名已知,静态键即可:
对照一单非会员美式——静态键:
**对照 = 结账摘要 品名="美式" 价=菜单[^美式]**
**对照 = 结账摘要 品名="美式" 价=[美式](菜单)**
**打印 内容=`对照`**
---
也可以把今日订单写成行表。循环里把行字段直接传给结账,少一层临时变量:
也可以把今日订单写成行表;循环头与取元同一套链接外形:
`今日订单` =
@@ -75,8 +76,8 @@ description: >-
| 1 | 燕麦拿铁 | 32 | 1 | True |
| 2 | 美式 | 18 | 2 | False |
- [`行`](`今日订单`)
**一行 = 结账摘要 品名=行[^品名] 价=行[^单价] 杯数=行[^杯数] 会员=行[^会员]**
- [行](今日订单)
**一行 = 结账摘要 品名=[品名](行) 价=[单价](行) 杯数=[杯数](行) 会员=[会员](行)**
**打印 内容=`一行`**
最后用加一收个尾,确认叙述里的位置调用也通: