---
title: "Markdown 组件 — zenit Zig UI"
description: "把受支持的 Markdown 子集渲染为原生节点。heading、强调、inline code、列表和引用生成真实可布局文本节点。"
url: https://zenit.z.express/zh/components/markdown
language: zh-CN
alternate_en: https://zenit.z.express/components/markdown.md
alternate_es: https://zenit.z.express/es/components/markdown.md
alternate_ja: https://zenit.z.express/ja/components/markdown.md
alternate_ko: https://zenit.z.express/ko/components/markdown.md
alternate_fr: https://zenit.z.express/fr/components/markdown.md
alternate_de: https://zenit.z.express/de/components/markdown.md
project: zenit v0.1.0-alpha (Zig 0.15.2, macOS)
source: https://github.com/version-next/zenit
---

# Markdown

`ui.widgets.Markdown`

把受支持的 Markdown 子集渲染为原生节点。

[Video](https://zenit.z.express/media/stories/markdown.mp4?v=212f340ccc)

**BEHAVIOR CONTRACT**

heading、强调、inline code、列表和引用生成真实可布局文本节点。

**RECORDED INTERACTION**

录像展示标题、粗体、斜体、列表与引用。

`examples/storybook/stories.zig:2871`

```zig
// ── Markdown ──
pub fn buildMarkdown(scope: *ui.Scope, cx: *ui.Cx) anyerror!*ui.Node {
    _ = scope;
    const md =
        \\# Markdown
        \\
        \\Supports **bold**, *italic*, and `inline code`.
        \\
        \\- bullet one
        \\- bullet two
        \\
        \\> A blockquote line.
    ;
    const res = try W.Markdown(md, .{ .base_font_size = 13 }).render(cx);
    return res.root;
}
```

[在 GitHub 查看源码examples/storybook/stories.zig:2871](https://github.com/version-next/zenit/blob/HEAD/examples/storybook/stories.zig#L2871)

这是 Storybook 中该 story 的原样代码（zenit 5f9add5+wip 2026-09-30）。其中 `W` 即 `ui.widgets`，`col` / `row` / `label` 是 Storybook 内的布局小工具。

### MarkdownBuilder

`ui.widgets.Markdown`

mount 直接返回 `MarkdownBuilder`，把它 append 到父节点即可。