文档已同步至 Markion v0.3.1 · 2026-09-04
文档
Markdown 与渲染
Markion 使用 pulldown-cmark 解析 Markdown,面向 CommonMark 与 GFM。Markdown 始终是文档的唯一数据格式。
格式化命令
格式化命令支持粗体、斜体、行内代码、链接、图片、标题、列表、任务列表、引用、围栏代码块和源码 Markdown 表格。标题命令默认显示 H1–H5,可在“偏好设置”中扩展为 H1–H6。
查找与替换
支持区分大小写、正则表达式、上一个/下一个匹配、替换当前项和全部替换。
表格
- 源码表格命令可格式化表格并新增、删除或移动行列。
- 可视化编辑中的表格还支持直接编辑单元格、使用 Tab 遍历、按内容分配列宽,以及同样的源码驱动行列操作。
- 普通预览中的表格保持只读。
本地图片工作流
支持剪贴板图片和拖入的图片文件:
- Markion 会以抗冲突的文件名将图片复制或编码到文档相对的资源目录中,并插入可移植的相对 Markdown 链接。
- 替换已有图片时不会丢失 alt 文本或展示元数据。
- 提供实用的尺寸/对齐控制,并在资源缺失时显示明确的缺失状态。
YAML 前言
可解析 --- 分隔的 YAML 前言并在预览中隐藏;其中的 title, author 和 date 会用于导出元数据(HTML <meta> 标签、DOCX 文档属性与 LaTeX 前言)。
渲染支持
渲染预览支持:
- 粗体、斜体、删除线、行内代码、链接、高亮(
==highlight==)、上标(^superscript^)、下标(~subscript~)、脚注、任务列表、常用 emoji 短代码(如:smile:、:heart:)和自动链接。 - 正确的有序列表起始编号、嵌套列表、分层项目符号、悬挂缩进、图片和嵌入式 HTML。
- 智能标点(弯引号、破折号)与标题属性。
预览复制
预览文本可以选中,并通过右键菜单复制为纯文本、Markdown 或 HTML;在适用位置还可复制链接地址。
数学公式
$...$ 行内公式和 $$...$$ 块级公式由内嵌的 RaTeX(兼容 KaTeX)引擎离线排版为带内嵌字体的 SVG 并缓存——无需联网,也无需安装外部 LaTeX。具体表现包括:
- 行内公式与正文保持同一行流畅排版,公式内可使用 Unicode 文本(如
$\text{速度 } v$)。 - 公式可与加粗、链接、行内代码等嵌套 Markdown 结构共存并保留各自样式。
```math围栏块(如矩阵环境)。- 超宽公式会横向滚动而不是被裁剪。
- 无效公式源码保持可见、可编辑,不会静默消失。
- 在可视化编辑中,只有聚焦的公式才显示其完整的
$...$,$$...$$或围栏源码。
LaTeX 导出保留原生 $...$/$$...$$ 源码,交给读者自己的工具链排版;内置 DOCX 导出会将公式降级为可读的纯文本近似显示,而非嵌入排版好的字形。
Mermaid 图表
```mermaid 围栏图表(流程图、时序图等)渲染为经过消毒处理的 SVG 并缓存。
代码高亮
使用 syntect 和 two-face 扩展语法集高亮围栏代码,对未覆盖语言使用后备词法分析,并可显示行号(可在偏好设置或 config.toml 中开关)。