MarkText 使用教程

从安装到导出的完整中文教程:三步快速上手、界面功能详解、公式图表写作、导出 PDF,以及完整快捷键速查表。以 v0.23.0 为准。

快速上手三步法

MarkText 上手门槛极低:装好就能写,中文界面开箱即用。三步进入写作状态:

1

下载并安装

到软件下载页按系统选包:Windows 下载 exe,双击运行安装向导——选"仅为我安装"免管理员权限,或"为所有用户安装"供多账号共用;macOS 下载 dmg,把图标拖进「应用程序」;Linux 下载 AppImage,赋予执行权限后双击即可运行。

2

新建或打开文档

启动后按 Ctrl+N 新建空白文档,或把任意 .md 文件直接拖进窗口。点左上角文件夹图标可打开整个文件夹,侧边栏会显示文件树,双击文件即可在标签页中打开。

3

直接开写

打字即所见即所得:输入 # 加空格变标题,- 变列表,> 变引用,选中文字会出现浮动工具栏。记不住语法就用顶部快捷栏或 Ctrl+Shift+P 命令面板。

提示:中文界面一般自动生效(跟随系统语言)。若显示英文,请到「文件 → 偏好设置 → 语言」手动切换为简体中文,重启编辑器即可。

界面功能认识

MarkText 的窗口非常克制,认识四个区域就够用了:

  • 左侧面板:文件树(管理文件夹内所有 .md 文件)、文件内搜索、目录大纲三个标签,点图标切换。
  • 顶部格式工具栏:选中文字时浮现,快速加粗、斜体、行内代码、插入链接与图片。
  • 编辑画布:唯一的写作区域,所见即所得。鼠标移到段落左侧会出现段落操作按钮(复制、删除、插入元素)。
  • 底部状态栏:显示当前文档的字数统计与光标位置,v0.23.0 起统计信息更完整。

右上角三个窗口按钮旁还有 tab 页管理:一次打开多个文档,用 Alt+数字 快速切换标签。文件树支持右键菜单新建、重命名、删除文件与"复制路径"(v0.21.2 新增)。

写作元素详解

标题与列表

行首输入 1–6 个 # 加空格生成各级标题;- 或 1. 生成无序/有序列表,- [ ] 生成 GFM 任务清单,点击方块可直接勾选。v0.23.0 起支持可折叠标题:把鼠标移到标题行左侧即可收起该章节,长文档浏览非常方便。

表格

按 Ctrl+Shift+T 插入 2×4 表格,顶部出现列操作按钮:左右插列、上下插行、对齐方式、删除。单元格内直接打字,所见即所得。

数学公式(KaTeX)

行内公式用一对 $ 包裹(如 $E=mc^2$),块级公式用一对 $$ 包裹后换行书写。MarkText 内置 KaTeX 渲染,输入完成即成像;还支持化学方程式(mhchem 扩展)。

图表(Mermaid / PlantUML)

插入语言为 mermaid 或 plantuml 的代码块,写完语法实时渲染流程图、时序图、甘特图,导出 PDF 时同样保留图形。导出为 HTML/PDF 时 Mermaid 渲染已在新版中更稳定(v0.24.0 进一步优化)。

GitHub 风格提示块(v0.22.0+)

用 > [!NOTE]、> [!TIP]、> [!WARNING] 等语法生成彩色提示框,与 GitHub 上的显示效果一致,写文档时标注注意事项很好用。

图片插入与图床

写图文教程最常用的流程:

  1. 任意截图后,在编辑器中直接 Ctrl+V 粘贴,图片默认保存到文档同目录的 assets 文件夹,并自动生成引用。
  2. 偏好设置中可修改图片保存位置(跟随文档 / 指定目录),也支持相对路径变量。
  3. 需要图床时,在「偏好设置 → 图片」中配置 PicGo 图床接口,粘贴后自动上传并替换为外链。
  4. 拖拽图片文件到编辑器窗口同样可以插入。
导出 PDF 后图片不显示?把 MarkText 升级到 v0.22.0 以上(已修复 Windows 图片路径问题),并确认图片使用相对路径引用。

主题与编辑模式

「文件 → 偏好设置 → 主题」中可切换官方主题:Cadmium Light(默认浅色)、Material Dark、One Dark、Graphite Light 等,界面与代码高亮一起切换。

编辑模式三件套:

  • 源码模式(Ctrl+/):切换到纯 Markdown 源码视图,精修语法后切回。
  • 打字机模式(Alt+Q 附近,菜单「视图」中):当前行始终保持在屏幕中部,长文输入不低头找光标。
  • 专注模式(Ctrl+Shift+J):淡化光标所在段落以外的内容,注意力集中在正在写的那一段。
  • 阅读 / 只读模式(v0.23.0 新增):隐藏编辑元素专心阅读,或把文档设为只读防止误改。

导出 HTML / PDF

  1. 打开要导出的文档,菜单「文件 → 导出」,或按 Ctrl+Shift+E。
  2. 选择 HTML:导出带内联样式的网页文件,贴到博客平台或浏览器打开都保留排版。
  3. 选择 PDF:在导出设置中可调页面大小、页边距与是否包含目录,确认后生成。
  4. 导出前确认文档中公式、图表渲染正常;长代码块在 PDF 中会自动换行(v0.20.0+)。
PDF 打印论文或报告前,建议先切到 Cadmium Light 主题再导出,浅色底更省墨、更正式。

快捷键速查表

以下为 Windows 默认键位(macOS 将 Ctrl 换为 Cmd),均可在「偏好设置 → 快捷键」中自定义:

新建文档Ctrl + N
打开文件夹Ctrl + Shift + O
保存Ctrl + S
查找Ctrl + F
命令面板Ctrl + Shift + P
切换源码模式Ctrl + /
专注模式Ctrl + Shift + J
插入表格Ctrl + Shift + T
导出文档Ctrl + Shift + E
加粗 / 斜体Ctrl + B / Ctrl + I
行内代码Ctrl + `
插入链接Ctrl + L
切换标签页Alt + 1–9
放大 / 缩小界面Ctrl + Shift + = / -

不同键盘布局下组合键以 US 键位映射(v0.17.0 起),个别键位如与软件内显示不符,以软件内快捷键设置页为准。

更多问题请查看 常见问题,或 立即下载 最新版 MarkText 体验。