MarkText MarkText
帮助文档

快速掌握 MarkText

从新手到高手，只需几分钟。这里汇集了快速上手指南、常用快捷键、Markdown 语法速查与常见问题解答， 帮助你充分发挥 MarkText 的全部潜力。

快速上手

三步开始你的第一次写作

无需任何配置，安装完成即可开始纯净写作。以下是首次使用的简要流程。

1. 新建文档

启动 MarkText 后，点击左上角「文件」菜单，选择「新建文件」即可创建一个空白的 Markdown 文档。 你也可以使用快捷键 Ctrl+N（macOS 下为 Cmd+N）快速新建。 新建的文档默认进入实时预览模式，你可以立即开始输入内容。

2. 选择主题与模式

在「偏好设置」中，你可以从六款内置主题中选择最适合自己的一款。 浅色主题如 Cadmium Light 适合白天使用，深色主题如 Material Dark 适合夜间写作。 同时，你可以在「视图」菜单中切换编辑模式：

  • 实时预览模式：默认模式，所见即所得
  • 源码模式：显示原始 Markdown 语法，按 Ctrl+Shift+S 切换
  • 专注模式：仅高亮当前段落，按 F8 切换
  • 打字机模式：光标始终居中，按 F9 切换

3. 保存与导出

写作完成后，按 Ctrl+S 保存为 .md 文件。 如需分享，可在「文件」菜单中选择导出为 HTML 或 PDF。 HTML 适合网页发布，PDF 适合打印分发。两种格式都会保留你在 MarkText 中看到的完整样式。

键盘快捷键

常用快捷键速查表

熟练使用快捷键能大幅提升写作效率。以下是 MarkText 最常用的快捷键，Windows/Linux 使用 Ctrl，macOS 使用 Cmd。

功能 Windows / Linux macOS
新建文件Ctrl + NCmd + N
打开文件Ctrl + OCmd + O
保存文件Ctrl + SCmd + S
另存为Ctrl + Shift + SCmd + Shift + S
切换源码模式Ctrl + Shift + SCmd + Shift + S
专注模式F8F8
打字机模式F9F9
切换主题Ctrl + Shift + TCmd + Shift + T
加粗Ctrl + BCmd + B
斜体Ctrl + ICmd + I
插入链接Ctrl + LCmd + L
插入代码块Ctrl + Shift + KCmd + Shift + K
插入表格Ctrl + Shift + TCmd + Shift + T
查找Ctrl + FCmd + F
替换Ctrl + Alt + FCmd + Alt + F
撤销Ctrl + ZCmd + Z
重做Ctrl + YCmd + Shift + Z
导出 HTMLCtrl + ECmd + E
导出 PDFCtrl + PCmd + P
关闭窗口Ctrl + WCmd + W
语法速查

Markdown 常用语法

MarkText 支持 CommonMark、GitHub Flavored Markdown 与 Pandoc 规范。以下是常用语法速查。

标题

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

文本样式

**加粗文本**
*斜体文本*
~~删除线~~
`行内代码`

列表

- 无序列表项 1
- 无序列表项 2
  - 嵌套列表项

1. 有序列表项 1
2. 有序列表项 2

链接与图片

[链接文本](https://example.com)
![图片描述](image.png)

代码块

```python
def hello():
    print("Hello, MarkText!")
```

引用

> 这是一段引用文本
> 可以跨越多行

表格

| 列 1 | 列 2 | 列 3 |
| ---- | ---- | ---- |
| A    | B    | C    |
| D    | E    | F    |

数学公式

行内公式：$E = mc^2$

块级公式：
$$
\int_{0}^{\infty} e^{-x^2} dx = \frac{\sqrt{\pi}}{2}
$$

Front Matter

---
title: 我的文档
date: 2024-01-01
tags: [markdown, marktext]
---
常见问题

FAQ · 你可能想知道的

以下是用户最常询问的问题。如果你有其他疑问，欢迎在 GitHub Issues 中提出。

是的，MarkText 完全免费开源，基于 MIT 协议发布。无论是个人使用、教育用途还是商业场景， 所有功能完全免费开放，不存在任何付费墙、订阅费或功能限制。你可以自由使用、修改、分发， 甚至将其作为商业产品的一部分。项目的开发与维护依赖社区赞助与志愿者贡献。

MarkText 支持 Windows 7/8/10/11、macOS 10.10+（含 Intel 与 Apple Silicon 芯片）、 Linux 64 位（Ubuntu、Debian、Fedora、Arch 等主流发行版）三大平台。 每个平台都提供原生安装包，确保最佳性能与兼容性。Linux 用户还可通过 Snap、Flatpak、AUR 等包管理器安装。

MarkText 与 Typora 都提供 WYSIWYG 实时预览体验，但两者有本质区别。 MarkText 完全免费开源（MIT 协议），而 Typora 为付费软件（约 14.99 美元）。 MarkText 拥有活跃的开源社区，任何人都可以审查、修改、贡献代码； Typora 为闭源商业软件。在功能上，两者都支持实时预览、多种主题、数学公式等核心特性， MarkText 在开源生态下持续迭代，所有更新永久免费。

MarkText 采用本地优先存储策略。所有文档默认保存在本地文件系统，采用纯 Markdown 文本格式。 无需登录账号，无需联网，数据完全归你所有。MarkText 不会将你的任何文档或使用数据上传到云端， 不存在任何追踪或遥测代码。你可以放心地用 MarkText 编写私密内容。 如需多设备同步，可结合 Dropbox、iCloud、Syncthing 等第三方同步工具实现。

在 MarkText 中，直接按 Ctrl+V（macOS 为 Cmd+V）即可粘贴剪贴板中的图片。 MarkText 会自动将图片保存到本地指定目录（默认为文档同目录下的 assets 文件夹）， 并在光标位置插入对应的 Markdown 图片引用。 你可以在偏好设置中自定义图片保存路径与命名规则。这一功能极大地简化了截图写作流程， 是技术博客与文档创作的效率神器。

在「文件」菜单中选择「导出」→「PDF」，或直接使用快捷键 Ctrl+P（macOS 为 Cmd+P）。 MarkText 内置 PDF 导出引擎，无需安装任何插件即可生成高质量 PDF 文件。 导出的 PDF 会保留你在 MarkText 中看到的所有样式，包括主题配色、字体、排版等。 你可以在偏好设置中自定义 PDF 的页面大小、边距、页眉页脚等参数。

MarkText 严格支持三大主流 Markdown 规范：

CommonMark Spec：业界标准化的 Markdown 规范，确保语法解析的一致性； GitHub Flavored Markdown (GFM)：扩展支持表格、任务列表、删除线、自动链接、代码块语法高亮等； Pandoc Markdown：选择性支持 Pandoc 扩展语法，包括脚注、引用、定义列表、数学公式等高级特性。

这种多规范支持让 MarkText 能够覆盖从笔记记录到学术写作的绝大多数场景需求。

MarkText 是开源项目，欢迎任何人参与贡献。如果你是开发者，可以在 GitHub 上提交 Pull Request 修复 bug 或实现新功能； 如果你熟悉某种语言，可以参与界面翻译；如果你擅长写作，可以完善用户文档。 请先阅读仓库根目录的 CONTRIBUTING.md 贡献指南，了解开发规范与提交流程。 即使不会写代码，也可以通过提交 Issue 反馈问题、在社交媒体分享 MarkText、或通过 Open Collective 赞助项目来支持我们。

这是 macOS 的安全机制 Gatekeeper 提示。由于 MarkText 是开源软件，未付费加入 Apple Developer Program， 因此首次打开时会被拦截。解决方法：在「系统偏好设置」→「安全性与隐私」中点击「仍要打开」； 或在终端执行命令 xattr -cr /Applications/MarkText.app 移除隔离属性。 这是开源软件在 macOS 上的常见情况，MarkText 的源代码完全公开可审计，请放心使用。

更多资源

深入了解更多

如果你想进一步了解 MarkText，以下资源可能对你有帮助。

官方文档

GitHub 仓库内的完整用户文档与开发者文档，涵盖所有功能的详细说明与配置选项，是进阶用户的必备参考。

前往查阅 →

问题反馈

在使用过程中遇到任何问题，欢迎在 GitHub Issues 中提交。清晰的问题描述能帮助开发者更快定位并修复。

提交 Issue →

赞助支持

MarkText 是免费的，但开发与维护需要投入大量时间。你的赞助能让项目持续健康发展，惠及更多用户。

支持项目 →