跳到主要内容
文心 · 万形

Markdown 全量

CommonMark 与 GFM 的常用标记。左边是作者写的输入，右边是对应 HTML 结构的实时样式预览，不是截图；示例说明文心如何呈现结构，不代替具体 Markdown 渲染器的兼容性测试。

标题与段落

Markdown渲染结果

## 二级标题
### 三级标题
#### 四级标题

普通段落不需要任何 class。

段落之间空一行。行末两个空格  
产生硬换行。

二级标题

三级标题

四级标题

普通段落不需要任何 class。

段落之间空一行。行末两个空格
产生硬换行。

标题从 ## 起用。一页只有一个 <h1>，它由页面标题或 front matter 提供，不由正文写出—— 这条由 check:site 强制，同时禁止跳级。

行内标记

Markdown渲染结果

*强调* 与 **加粗**，
~~删除线~~，`行内代码`，
==高亮==（扩展语法）。

链接 [文心](#inline)、
自动链接 <https://example.com>、
脚注引用[^1]。

转义 \*不是强调\*。

[^1]: 脚注正文。

强调 与 加粗，删除线，行内代码，高亮（扩展语法）。

链接 文心、自动链接 https://example.com、脚注引用1。

转义 *不是强调*。

  1. 脚注正文。↩
中文没有真正的斜体

浏览器为中文合成的伪斜体读起来像渲染故障，所以 :lang(zh) 下的 em 渲染为加重而不是倾斜。i、cite、dfn、var 同理。

列表

Markdown渲染结果

- 无序列表
- 第二项
  - 嵌套一层
    - 再嵌套

1. 有序列表
2. 第二项

5. 从 5 开始
6. 继续

- [x] 已完成
- [ ] 未完成
  • 无序列表
  • 第二项
    • 嵌套一层
      • 再嵌套
  1. 有序列表
  2. 第二项
  1. 从 5 开始
  2. 继续
  • 已完成
  • 未完成

Markdown · 松散列表渲染结果

- 项与项之间有空行时，

- 每一项会被包进段落，

- 行距随之变松。

  • 项与项之间有空行时，

  • 每一项会被包进段落，

  • 行距随之变松。

引用、分隔线与定义列表

Markdown渲染结果

> 引用一段话。
>
> > 嵌套引用。

---

术语
: 定义列表是扩展语法。

另一个术语
: 它的解释。

引用一段话。

嵌套引用。

术语
定义列表是扩展语法。
另一个术语
它的解释。

嵌套引用沿用同一条单边线，只缩进一级并降低线条对比度；层级可见，但不会叠成装饰性的套框。

折叠内容

Markdown · 内联 HTML渲染结果

<details open>
  <summary>查看补充说明</summary>

  这里放补充正文。
</details>
查看补充说明

这里放补充正文。

内容层只处理没有 class 的原生 details/summary：浏览器负责键盘开合与 open 状态，样式只补正文节奏。带有 .wx-collapse 等 class 的组件继续遵守自己的契约。

表格

Markdown渲染结果

| 左对齐 | 居中 | 右对齐 |
| :----- | :--: | -----: |
| [文心](#table) | 万形 |   1.5px |
| 留白   | 克制 |    36em |
左对齐居中右对齐
文心万形1.5px
留白克制36em

宽表格由渲染器包进 .table-scroll，在自己的容器里横向滚动，而不是把整页撑宽。

图片与图注

Markdown渲染结果

![万形印章](logo-wanxing.svg)

带图注时渲染器输出 figure：

<figure>
  <img src="…" alt="…">
  <figcaption>图注：<a href="#media">文心</a></figcaption>
</figure>

万形朱砂印章

文心朱砂印章
图注：文心，知识与生长。

渲染器不该凭空造图注。一个没有 figcaption 的 img 就是没有图注，把 alt 文本搬去当图注是伪造语义——alt 是给读不到图的人的，图注是给所有人的。

提示块

Markdown 本身没有提示块，各家扩展语法不同。样式层同时认三种主流写法，作者用哪一种由渲染器决定。

Markdown 提示块（GFM）渲染结果

> [!NOTE]
> 一般说明。

> [!TIP]
> 建议。

> [!WARNING]
> 警告。

> [!CAUTION]
> 危险操作。

说明

一般说明。

建议

建议。

警告

警告。

危险

危险操作。

认得的 class：.admonition.tip、.alert-tip、.markdown-alert-tip—— 分别对应 Python-Markdown / Docusaurus / GitHub 三家，不需要中间映射层。

代码块

Markdown渲染结果

```css
.wx-rule {
  /* 单边线，不是四边框 */
  border-block-start: 1px solid;
}
```
.wx-rule {
  /* 单边线，不是四边框 */
  border-block-start: 1px solid;
}

语法高亮的完整 token 表、支持的高亮器与实测对比度见代码与语法高亮。

覆盖情况

诚实记录边界比声称"全支持"有用。下表按标准分组，写清哪些是 CommonMark、哪些依赖扩展、哪些不做。

标记标准状态
标题（ATX / Setext）、段落、软硬换行CommonMark✓
强调、加粗、行内代码、转义CommonMark✓
链接（行内 / 引用式 / 自动）、图片CommonMark✓
列表（有序 / 无序 / 嵌套 / 起始序号 / 松散紧凑）CommonMark✓
引用（含嵌套）、分隔线CommonMark✓
代码块（围栏 / 缩进 / 语言标注）CommonMark✓
内联 HTML（含原生 details/summary）CommonMark✓ 按裸元素样式呈现
表格（含对齐）、删除线、任务列表GFM✓
脚注GFM / 扩展✓
提示块 alertsGFM / 扩展✓ 三家 class 同时认
定义列表、高亮 ==…==、上下标扩展✓ 渲染器需支持
注音 ruby内联 HTML✓
数学公式 $…$扩展✗ 需自行接入 KaTeX/MathJax，样式层不含
目录 [TOC]扩展✗ 由站点生成器负责，见 wx-anchor
Front matter扩展✗ 元数据不是内容，不渲染