Files
marqdo/examples/code-as-docs/index.mq.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

87 lines
2.4 KiB
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.
---
title: 代码即文档 · 周末咖啡手账
description: >-
一份可读可跑的周末手账:菜单是表,计价写在段落里,主流程像日记。
展示叙述统一写法、链接形取元 [键](集合)、浮点折扣,以及粗体内免 `>` 的调用。
---
本文件既是**说明**也是**程序**。人读得到段落与表格;机器执行嵌在叙述里的粗体步骤,并把斜体当作返回值。
不必回避 Markdown 强调——不像代码的 `**说明**` 只是装饰。段落之间也可以用分隔线:
---
## 单价
一杯标价为`价`的饮品,默认`杯数`=1。先算**总额 = 价 * 杯数**,再返回*总额*。
## 会员折
会员单需要原价`原价`;门店默认八五折,写作`折扣`=0.85。
先算**应付 = 原价 * 折扣**,再返回*应付*。
## 结账摘要
客人点了`品名`,单价`价`,杯数`杯数`=1;是否`会员`=False。
小计交给单价:**小计 = 单价 价=`价` 杯数=`杯数`**。
1. `会员`
**实付 = 会员折 原价=`小计`**
**标签 = "会员价"**
2. *
**实付 = 小计**
**标签 = "原价"**
拼成一句给人对账的话,然后返回:
**文案 = 品名 + " ×" + 杯数 + " → " + 标签 + " " + 实付**
*文案*
## 加一
对于输入`n`,执行**n=n+1**接着返回*n*。
# main
周末手账从一张菜单开始。数据用表格写——人一眼能读,程序把它当成字典:
`菜单` =
| 美式 | 拿铁 | 燕麦拿铁 |
|------|------|----------|
| 18 | 28 | 32 |
---
第一单:会员双杯拿铁。品名记在变量里,用链接形取元 `` [`名`](菜单) ``(与循环 `[项](集合)` 同形):
**名 = "拿铁"**
**价 = [`名`](菜单)**
**摘要 = 结账摘要 品名=`名` 价=`价` 杯数=2 会员=True**
**打印 内容=`摘要`**
对照一单非会员美式——静态键:
**对照 = 结账摘要 品名="美式" 价=[美式](菜单)**
**打印 内容=`对照`**
---
也可以把今日订单写成行表;循环头与取元同一套链接外形:
`今日订单` =
| @ | 品名 | 单价 | 杯数 | 会员 |
|---|------|------|------|------|
| 1 | 燕麦拿铁 | 32 | 1 | True |
| 2 | 美式 | 18 | 2 | False |
- [行](今日订单)
**一行 = 结账摘要 品名=[品名](行) 价=[单价](行) 杯数=[杯数](行) 会员=[会员](行)**
**打印 内容=`一行`**
最后用加一收个尾,确认叙述里的位置调用也通:
**试算 = 加一 41**
**打印 内容=`试算`**