# Markdown 查看器 — Liu Terminal

> Liu Terminal Markdown 查看器。在终端内渲染 .md 文件，支持实时预览、语法高亮和 GitHub 风格格式化。

URL: https://liu.software/zh/docs/markdown/  
Language: zh  
Updated: 2026-10-17

在 Liu 内阅读 README、设计笔记和代理输出——带图像、表格、任务列表、维基链接和代码块的样式化渲染，并可切换原始源码与文内搜索。

**正在重写中。** 解析器和渲染器位于 src/ui/markdown/（md\_parse.c、md\_render.c、md\_image.c、md\_graph.c、md\_math.c、md\_diagram.c）。查看器集成在 src/ui/filebrowser.c — AST 结构与图像管线可能变动。

## 打开文档

在文件浏览器中点击任意 .md 或 .markdown 文件。Liu 就地解析缓冲区（AST 切片指向已加载文件文本），通过同一终端字体图集渲染字形，并以平滑像素滚动排版块。

切换到原始模式可在基于行的编辑器中编辑源码，复用与代码视图相同的查找/替换机制。未保存的编辑会将缓冲区标记为已修改，直到写回磁盘。

## 当前支持的渲染

- 标题、段落、强调、删除线、行内代码、链接、自动链接、图像（加载时解析本地路径）。
- 带每块 Copy 按钮的围栏代码块、表格、项目/编号/任务列表（复选框可点击）。
- 标注框、引用块、维基链接/\[\[嵌入\]\]、#标签、脚注引用。
- 数学与图表块经 md\_math.c / md\_diagram.c 处理（覆盖范围仍在扩展）。

## 扩展语法与限制

原生解析器还支持 YAML frontmatter（包括 title、tags 和 aliases）、定义列表、脚注定义和内联脚注、==高亮==、^上标^、~下标~、\<details\> 块以及 Mermaid 图表的原生子集。原始 HTML 以暗淡的等宽文本显示；不会执行脚本。

## 导航辅助

- ⌘ K → Go to Heading 通过每次渲染收集的大纲跳转（最多 512 个标题）。
- ⌘ K → Open Note 可模糊搜索并打开 Notes Vault 下的任意 Markdown 文件。
- ⌘ K → Search Notes 在命令面板中扫描库文件内容。
- 文内查找/替换在渲染和原始模式下均可用（触控板滚动像命令面板一样累积像素——约每 tick 24–40 px）。

## 知识图谱

Graph View（库）或 Graph Current Folder 会构建 Markdown 文件的力导向图——可在图谱设置面板调整维基链接、标签和孤立节点过滤。布局工作线程异步运行，大型库不会冻结 UI。

[下一步 命令面板 →](https://liu.software/zh/docs/palette.md)