Markdown 变体版图

{#warn .warning}
::: warning
别在生产库上跑这条命令。
:::

::: {#warn .warning}
别在生产库上跑这条命令。
:::

```{warning}
:name: warn
别在生产库上跑这条命令。
```

{% callout type="warning" #warn %}
别在生产库上跑这条命令。
{% /callout %}

=== note {#warn}
别在生产库上跑这条命令。
===

=== table {#cost format=csv header=1}
Item,Cost
Hosting,120
===

=== data {#vars format=json}
{"owner": "docs"}
===

Djot / Pandoc：见 [预算](#budjet)
MyST：见 {ref}`budjet`
Quarto：见 @fig-budjet
AsciiDoc：见 <<budjet>>

# 预算 {#budget}

托管费每月 120 元。

# 附录 {#appendix}

见 [[#budjet]]。

$ mq '.h(2)' README.md                     # 所有二级标题
$ mq '.code("rust")' README.md              # 所有 rust 代码块
$ mq 'section::section("Installation")' README.md
$ mq -U '…' README.md                     # 改写后把整篇打到 stdout

$ geml list doc.geml
#install                 heading  h1    L1-8   安装
#install-before-upgrade  prose          L3-3
#upgrade                 heading  h2    L5-8   升级
#usage                   heading  h1    L9-12  用法

$ geml find 升级 .
doc.geml	#upgrade

$ geml get doc.geml '#install' --head
# 安装 {#install}

$ geml rename doc.geml '#install' '#setup'
# 安装 {#setup}
见 [[#setup]]。                  # 引用一起改

$ geml list doc.geml --within '#install'
#install-before-upgrade  prose          L3-3
#upgrade                 heading  h2    L5-8  升级

$ geml get complex-form.geml '=== form-field {type=date}'
4 `form-field` blocks (L48-49 #founded · L99-101 #iso-expiry · …)

<!-- 目标文件的 frontmatter -->
---
uuid: 7f3a1e2c-…
---

<!-- 引用方 -->
[设计文档](docs/design.md) <!-- uuid: 7f3a1e2c-… -->

见 [[design.geml#arch]]。

```go file=main_test.go region=example
…
```

源文件里用 #region example 注释圈出一段。mdcode update 把源码拉进文档，mdcode extract 把文档里的改动推回源文件。

<<< @/snippets/demo.ts#region-name {2,3|5}
---
src: ./other.md#2,5-7      按页码取另一份幻灯片
---

!include (test.js lang=javascript)   markedpp，找不到就原样留着
{{chapter2.md}}                      MultiMarkdown 整文件嵌入
include::part.adoc[tag=intro]        AsciiDoc，按 tag 取一段

=== code {#add lang=js src=src/math.js#L1-3}
===

=== code {#gone lang=js src=src/math.js#L40-45}
===

=== embed {src=guide.geml#install part=intro}
===

import { Chart } from './Chart.jsx'

# 季度营收

<Chart data={rows} type="bar" />

---
layout: two-cols
---
# 季度营收
<BarChart :data="rows" />

=== table {#q format=csv header=1}
Quarter,Revenue
Q1,120
Q2,180
===

=== diagram {#rev format=geml-chart data=#q type=bar x=Quarter y=Revenue}
===