From 6d6f580d244e4a30714c227cf28d96d4b18359e6 Mon Sep 17 00:00:00 2001 From: cflmy Date: Fri, 13 Nov 2026 12:06:30 +0800 Subject: [PATCH] docs: lead with Markdown-to-execution film and original View imagery --- README.md | 30 ++++++++++++++++++++++++++---- 1 file changed, 26 insertions(+), 4 deletions(-) diff --git a/README.md b/README.md index 2d38f06..4715db1 100644 --- a/README.md +++ b/README.md @@ -15,6 +15,7 @@ **Not a prompt wrapper.** The document is interpreted as a program by Marqdo; its tool functions are not merely natural-language instructions.

+56s film · Quickstart · Procurement demo · View · @@ -23,9 +24,26 @@ Release notes

-![Verified Marqdo procurement calls animated from actual CLI results](assets/marketing/procurement-cli.gif) +## One Markdown file. Three views. Real execution. + +[![Watch Marqdo 2.7.1 — from Markdown to execution](assets/marketing/marqdo-2.7.1-markdown-to-execution-cover.jpg)](assets/marketing/marqdo-2.7.1-markdown-to-execution.mp4) + +**[▶ Watch the 56-second film](assets/marketing/marqdo-2.7.1-markdown-to-execution.mp4)** · [Bilingual captions](assets/marketing/marqdo-2.7.1-markdown-to-execution.srt) · [Reproducible video source](scripts/render-markdown-execution-promo.py) + +> **The point is not to invent a new document format.** A `.mq.md` file uses Markdown headings, paragraphs and tables. Ordinary Markdown renderers still show a readable document. Marqdo adds explicit execution semantics and a View that can inspect functions, values and their relationships on the same document. + +![Three views, one source — source Markdown, rendered Markdown, executable View](assets/marketing/source-markdown-view-concept.png) + +**Concept artwork** showing the design principle: **source → ordinary Markdown rendering → Marqdo View**. Illustrative labels are not a live execution trace. The video includes [a real View screenshot](assets/marketing/user-procurement-view.png), [a standard Markdown rendering](assets/marketing/marqdo-procurement-standard-markdown.png) produced from the actual procurement source, and a business example verified with the 2.7.1 CLI. + +**One `.mq.md` source, three ways to interact:** + +| Source | Standard Markdown | Marqdo runtime + View | +|---|---|---| +| Edit the same Markdown text | Read headings, prose and data tables | Inspect the same document's calls, values and effects | +| No separate prompt or tool implementation specification needed | Works as ordinary readable documentation | Call named functions with `marqdo call` | + -Animated walkthrough assembled from **real Marqdo 2.7.1 function-call results**, including the accepted **simulated** order and an over-budget refusal. Curated frames, not a recording of typing or a production transaction. [Reproduce the capture](scripts/capture-procurement-showcase.py) · [CI run](https://github.com/cflmy/marqdo/actions/runs/43358103498). ## Quickstart — one function, one command @@ -44,6 +62,10 @@ The function heading is the callable name. The function's explanation, parameter This is a **seven-tool, offline demonstration**. It knows the local supplier directory, queries a static price catalog, checks the budget, and conditionally creates a **simulated** work order. It also documents receipt handling, negotiation and supplier switching as unconnected stubs. +![Animated results from real Marqdo 2.7.1 function calls](assets/marketing/procurement-cli.gif) + +**Real CLI results**, edited into a short animation; the accepted order is explicitly **simulated** and never sent. [Capture workflow](scripts/capture-procurement-showcase.py) · [Passing checks](https://github.com/cflmy/marqdo/actions/runs/43358288563). + ```bash # 1. Approve suppliers: paused or blacklisted entries are excluded. marqdo call examples/procurement/index.mq.md 查询采购商 "采购商状态='正常'" --json @@ -79,9 +101,9 @@ Marqdo 2.7.1 improves the interactive reading experience: implementation details marqdo view examples/procurement --no-open ``` -![Actual Marqdo 2.7.1 View screenshot of procurement function](assets/marketing/procurement-view.png) +![Marqdo View — original detailed screenshot provided by the project author](assets/marketing/user-procurement-view.png) -**Actual screenshot** captured in Chromium from a Marqdo **2.7.1** View static export, scrolled to `向采购商发工单`. It shows the real rendered document, not a promotional mockup. [Screenshot generation source](scripts/capture-procurement-showcase.py). +**Original View screenshot provided by the project author.** Notice the natural document typography, values in the margins, and curved connections originating from function calls in the prose. [Additional automated View capture](assets/marketing/procurement-view.png) · [Static Markdown rendering](assets/marketing/marqdo-procurement-standard-markdown.png). ## One document, multiple uses