Files
marqdo/examples/code-as-docs/index.mq.md
T
cflmyandCursor 5e74ff39f2 feat(markup): code-as-docs narration surface (G1–G4) and drop --- body end
Treat --- as Markdown HR everywhere, end side-effect helpers with empty returns,
and accept soft emphasis, float literals, and dynamic footnote keys so LLM-friendly
.mq.md stays runnable. Ship the weekend coffee example plus gold fixtures.

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

2.5 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 打印 内容=试算