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

2.4 KiB
Raw Blame History

title, description
title description
代码即文档 · 周末咖啡手账 一份可读可跑的周末手账:菜单是表,计价写在段落里,主流程像日记。 展示叙述统一写法、链接形取元 [键](集合)、浮点折扣,以及粗体内免 `>` 的调用。

本文件既是说明也是程序。人读得到段落与表格;机器执行嵌在叙述里的粗体步骤,并把斜体当作返回值。 不必回避 Markdown 强调——不像代码的 **说明** 只是装饰。段落之间也可以用分隔线:


单价

一杯标价为价的饮品,默认杯数=1。先算总额 = 价 * 杯数,再返回总额。

会员折

会员单需要原价原价;门店默认八五折,写作折扣=0.85。 先算应付 = 原价 * 折扣,再返回应付。

结账摘要

客人点了品名,单价价,杯数杯数=1;是否会员=False。

小计交给单价:小计 = 单价 价=价 杯数=杯数。

  1. 会员 实付 = 会员折 原价=小计 标签 = "会员价"

实付 = 小计 标签 = "原价"

拼成一句给人对账的话,然后返回:

文案 = 品名 + " ×" + 杯数 + " → " + 标签 + " " + 实付 文案

加一

对于输入n,执行n=n+1接着返回n。

main

周末手账从一张菜单开始。数据用表格写——人一眼能读,程序把它当成字典:

菜单 =

美式 拿铁 燕麦拿铁
18 28 32

第一单:会员双杯拿铁。品名记在变量里,用链接形取元 [`名`](菜单)(与循环 [项](集合) 同形):

名 = "拿铁" 价 = 名 摘要 = 结账摘要 品名=名 价=价 杯数=2 会员=True 打印 内容=摘要

对照一单非会员美式——静态键:

对照 = 结账摘要 品名="美式" 价=美式 打印 内容=对照


也可以把今日订单写成行表;循环头与取元同一套链接外形:

今日订单 =

@ 品名 单价 杯数 会员
1 燕麦拿铁 32 1 True
2 美式 18 2 False

最后用加一收个尾,确认叙述里的位置调用也通:

试算 = 加一 41 打印 内容=试算