- CHANGELOG.md:v2.8.0 条目(中英双语); - README.md:版本行 2.7.1→2.8.0 + 愿景第 6 条(知识可证明); - doc/releases/v2.8.0.md:双语发版说明(亮点/用法/已知限制); - skills/marqdo-dev/index.mq.md:新增 prove 任务(路径/目录模式/ require_lean/json;参数用 + 行声明升参,check 与 narrative-ratio 通过); - 设计文档 §12.5 标记已合入;发版链接统一指向 doc/releases/v2.8.0.md。
4.1 KiB
Executable File
4.1 KiB
Executable File
Markup → meaning (v0.3)
| Marker | Meaning |
|---|---|
# |
Object / type (constructor body). # main = entry object. # Child = > Parent = inherit (no implicit parent constructor; call `self` = > Parent … explicitly when needed). |
## … ###### |
Function / method (nesting by heading depth). |
+ `name` under heading |
Parameter (optional `name`=default) |
1. 2. … in body |
Branch arm (condition or N. * else). Same-indent restart at 1. = new branch statement (not more arms of the previous list). |
- … inside body |
Loop (while or [item](coll) / [`item`](`coll`)) |
Line N. * |
Else arm |
> fn args |
Call (named k=v or positional) |
修饰 [fn] args |
Bracket-marked call; leading words → 名=True |
> `obj`.method args |
Method call (obj must be a map with _type) |
Frontmatter nested import: / 导入: map |
Import file (bind: path.mq.md) or short name (bind: lib.member) |
> lib.member … / > lib.Type.member … |
Call via bare dotted path (instance methods need `var`.m) |
**…** |
Code (assign / call) — closing ** touches last token; bare ids are variables; quote text literals |
*…* |
Return value — closing * touches last token; bare ids are variables |
**** / whole-line ** / *None* |
Return None and end function body |
Lone --- / *** |
Markdown thematic break (skip; not function end) |
| GFM table after empty RHS bind | Collection; get with [key](coll) (preferred) or legacy `m`[^key] |
- [item](coll) |
Foreach (unchanged) |
```lang |
Foreign code block (via lib/foreign) |
`"text"` |
Quoted string (\n \t \\ \"; `var` inside); bare tokens unescaped |
| Unmarked prose | Comment |
Entry: load file (often index.mq.md) → collect defs → run # main.
Minimal program
# main
> print text=Hello World!
Chinese builtins (same functions, no import):
# main
> 打印 内容=你好
Functions, calls, end-body
# main
> greet who=Marqdo
## greet
+ `who`
> print text=Hello, `who`!
*None*
- Call:
> name key=valueor> name value. - Nested helpers use deeper
#(##,###, …). - After a helper with only side effects, end with
*None*/ whole-line**/****when later lines must stay in the outer function. Lone---is only a thematic break (skipped). - In bold assigns, prefer bare calls:
**摘要 = 结账摘要 …**(omit>).
Statements, returns, branches
**x = 1**
**y = x + 2**
## add_one
+ `n`
*n + 1*
**n = 0**
1. `n` > 0
> print text=positive
2. `n` < 0
> print text=negative
3. *
> print text=zero
Frontmatter imports + stdlib
Imports use nested YAML import: (导入 equivalent): file (.mq.md) or short name (lib.member). Members are not flattened into the caller. Call with a bare dotted path:
---
title: example
import:
text: lib/text.mq.md
clock: lib/time.mq.md
---
# main
**xs = > text.str_split s="a,b,c" sep=","**
> print text=`xs`
**t = > clock.now_unix**
- Import English or Chinese library file; call that file's API names via
lib.member(do not mix languages). - Instance methods stay
> `obj`.method(backticks on the receiver only). lib/…resolves viaMARQDO_LIB, cwdlib/, orlib/next to themarqdobinary.- Prefer
table.put/表.改for list/map element updates; keepjsonfor parse/stringify/quote. - Builtins (no import):
print/打印,input/输入,len/长度,str/文本,int/整数; literalsTrue/真,False/假,None/空; logicand/且,or/或,not/非.