Files
marqdo/examples/link-syntax
cflmyandCursor 687c168014 feat(parse): use nested YAML import: maps instead of one-liner binds
Frontmatter imports are now valid YAML (`import:` / `导入:` with bind→target
entries), removing spaced keys. Add `marqdo migrate imports`, hard-error the
old one-liner form, and migrate lib/ext/examples/tests/docs accordingly.

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-10-23 19:33:58 +08:00
..

链接语法示例:两文档,一次类调用

这个目录是 链接语法设计声明 的目标示例:

[李白的出生年份](李白.李白的出生年份) 不是新的语法:[] 是 Markdown 链接的描述,() 是已有调用; # 李白 是类,## 李白的出生年份 是函数,李白.李白的出生年份 是类调用。

文件

文件 作用 v2.0.0 可跑 v2.1 目标
libai.mq.md 知识文档:# 李白 → ## 李白的出生年份 → *701* ✅ ✅
main.mq.md 用户原始示例:正文链接 + 类调用 ❌(安静无输出) ✅ view 显示;run 加 print 输出
main.compat.mq.md 当前等价写法:import + 实例 + 本地链接 ✅(输出 701) ✅
expected-link-info.json 目标 LinkInfo 形状 — —
links.lock.yaml 可选锁文件形状 — —

v2.0.0 的 main.mq.md 不会报错,也不会有输出——因为:

  1. 正文链接默认不执行(叙述默认安全);
  2. 李白.李白的出生年份 目前被当成变量/实例方法路径,类调用还没实现。

v2.1 的目标是:view 显示这个链接的目标、类、函数、签名、值;check 返回 LinkInfo; 要终端输出,就在代码链接里加 print。

今天可跑

marqdo run examples/link-syntax/main.compat.mq.md
# 701

main.compat.mq.md 用当前能力完成了同一件事:

---
markup: occlusion
import libai:libai.mq.md
---

# main

**li = > libai.李白**
**year = [李白的出生年份](li.李白的出生年份())**
> print text=`year`
  • import 绑定知识文档;
  • > libai.李白 构造对象(当前 # 是对象/类型);
  • li.李白的出生年份() 调用实例方法;
  • []() 把调用包成一句人话。

这正是 v2.0.0 的「实例方法」路径;v2.1 要把 ## 恢复为类函数, 让 李白.李白的出生年份 直接调用,去掉 import/实例两步。

目标形式

main.mq.md:

# main
用户想要知道李白的出生年份,我们要告诉用户[李白的出生年份](李白.李白的出生年份)

v2.1 期望:

$ marqdo run examples/link-syntax/main.mq.md
# 无输出(正文链接不执行;加 print 才有输出)

$ marqdo check examples/link-syntax/main.mq.md --json
{"code":"link.ok", ...}

view 期望:

用户想要知道李白的出生年份,我们要告诉用户 701。
                                      ↑
        悬浮:李白的出生年份 → 李白.李白的出生年份
              class 李白 · function · () -> number · value 701

要终端输出:

# main

**year = [李白的出生年份](李白.李白的出生年份)**
> print text=`year`
$ marqdo run examples/link-syntax/main.mq.md
701

为什么是 李白.李白的出生年份

  • # 李白 是类;
  • ## 李白的出生年份 是类下的函数;
  • 李白.李白的出生年份 是类调用;
  • [] 是描述,() 是已有调用;没有新语法,没有协议前缀,没有别名开关。

相关