MarkText：让 Markdown 编辑器从你的视线中消失 #

MarkText 是什么？ #

MarkText 是一款免费、开源、实时预览的 Markdown 编辑器，支持 macOS、Windows 与 Linux 三大桌面平台。它主打“真正的所见即所得”——你输入的 Markdown 语法会在原地立即渲染成最终样式，标题变大、强调倾斜、代码就位，全程无需分栏预览、无需切换窗口，也不会打断写作心流。

它面向写作者、博客作者、技术文档工程师、开发者和学生等所有需要长期使用 Markdown 的人群，解决了传统编辑器“左边写源码、右边看效果，视线来回切换”的痛点。MarkText 基于 Electron 构建，遵循 CommonMark 与 GitHub Flavored Markdown（GFM）标准，并把表格、数学公式、图表、脚注、Front matter 等进阶语法作为一等公民原生支持。项目采用 MIT 许可证，永久免费，无账号、无追踪。

MarkText 有哪些亮点特色？ #

• 所见即所得的实时渲染：MarkText 是真正的 WYSIWYG 编辑器，你输入 ## 标题，标记符号会当场"融化"为标题样式；输入 **粗体** 立即加粗，链接在写完的瞬间变为可点击状态。没有分栏预览，没有渲染按钮，没有预览切换。

• 33 款内置主题与自定义 CSS：内置 33 款明暗主题（如 Cadmium、Dark、Graphite、Material、Ulysses、One Dark 等），一次快捷键即可切换，也可跟随系统深浅色。所有主题本质上都只是 CSS，没有任何私有格式——懂 CSS 就能自己写主题，也能 fork 现有主题改造。

• 超越 CommonMark 的 Markdown 扩展：表格可视化编辑、KaTeX 行内与块级数学公式（如 e^iπ + 1 = 0、积分表达式）、Mermaid 与 Vega / Vega-Lite 流程图与图表、PlantUML 图、双向自动重编号脚注、数百种语言的代码块语法高亮，以及 YAML / TOML / JSON 三种 Front matter，全部开箱即用、实时渲染。

• 专注模式与打字机模式：专注模式会把当前正在写的段落之外的内容全部淡化，打字机模式则让光标所在的行始终锁定在屏幕中央，撰写长文时视线无需追逐光标，从设计上实现"无干扰"。

• 文档导出与主题同步：任意文档都可以一键导出为排版精良的 PDF 或自包含（self-contained）的 HTML 文件，导出结果会自动包含你当前使用的主题样式，所见即所得地交付成品。

• 源码模式与粘贴即转换：需要完全掌控时可以随时切入原始 Markdown 源码模式；从浏览器或 Word 粘贴富文本时，MarkText 会自动将其转换为干净的 Markdown，省去手工清洗格式的麻烦。

• 跨平台且完全开源免费：官方提供 macOS（Apple Silicon 与 Intel）、Windows（x64 与 ARM64）、Linux（AppImage / deb / rpm / snap / tar.gz 五种格式）安装包，并支持 brew install --cask mark-text 快速安装。项目基于 MIT 许可证开源，GitHub 上拥有 56.6k+ Star、146 位贡献者，无账号、无追踪、无订阅。

• 活跃维护与规范的发布流程：项目采用自动化的发布流水线，标签推送后自动完成校验、五平台矩阵构建与发布，产出包含 SHA256SUMS.txt 校验文件在内的 24 项发布产物，更新版本由应用在启动时自动检查并在后台下载。

免费下载 MarkText #

以下为官方提供的各平台安装包（当前为 v0.20.0-rc.6 预发布版本），点击链接即可下载。网盘下载无需账号登录即可获取文件。

提示：官方为每个版本提供 SHA256SUMS.txt 校验文件，下载后可自行核验安装包完整性。Linux 用户可前往官网或 GitHub Releases 获取 AppImage、deb、rpm、snap 与 tar.gz 格式。

MarkText 如何使用？ #

MarkText 的上手成本极低，安装后两分钟内即可开始写作。基本流程如下：

1. 下载并安装：根据自己的系统与处理器架构，从上方表格中选择对应安装包下载安装（详见下文“如何安装”）。

2. 新建或打开文档：启动 MarkText，点击新建文件开始写作，或用“打开文件夹”把一个目录作为工作区载入，MarkText 会在侧边栏以树形结构展示文件列表，方便在多个笔记之间切换。

3. 直接开始写 Markdown：在主编辑区输入内容，语法会实时渲染。试试输入 ## 标题、**粗体**、*斜体*、- 项目符号，你会看到标记符号自动变形为最终样式；列表会自动接续，嵌套层级只需一次 Tab 缩进，- [ ] 会生成可勾选的复选框。

4. 插入进阶元素：使用工具栏或菜单插入表格、行内/块级数学公式（KaTeX）、Mermaid 流程图与图表、脚注、Front matter 等。如果从网页或文档粘贴富文本，MarkText 会自动转换为干净的 Markdown。

5. 切换主题与写作模式：用快捷键切换 33 款内置主题之一，或跟随系统深浅色；需要长时间专注时开启专注模式（淡化非当前段落）与打字机模式（当前行锁定居中）。

6. 导出成品：完成写作后，通过导出功能把文档输出为带主题样式的 PDF 或自包含 HTML 文件；如果你更习惯命令行，也可以使用 CLI 完成导出，例如 marktext notes.md --export pdf。

7. 源码模式（可选）：随时按下切换键进入原始 Markdown 源码模式，进行精细的格式调整后再切回所见即所得视图。

MarkText 的常见问题？ #

MarkText 是免费的吗？会有付费版本吗？ 完全免费。MarkText 基于 MIT 许可证开源，官网明确表示“Free & open source forever”，无需账号、无需订阅、无追踪。项目由志愿者开发维护，如果你认可它，可以通过 GitHub Sponsors 赞助支持开发。

macOS 首次打开时提示“无法验证开发者”怎么办？ 官网说明当前 macOS 构建尚未经过 Apple 公证（notarized），因此首次启动可能触发系统 Gatekeeper 拦截。解决方法是：在 Finder 中右键点击 MarkText 应用图标，选择“打开”，在弹窗中确认一次即可，之后可正常双击启动。

MarkText 会自动更新吗？ 会。MarkText 在启动时检查更新（可在“偏好设置 → 通用 → 更新”中关闭），发现新版本后在后台下载，下次重启时安装。但需要注意：便携版（Portable）和 Linux AppImage 不自动更新，需要手动重新下载最新版本文件。

支持哪些 Markdown 语法？和 GitHub 上的写法兼容吗？ MarkText 遵循 CommonMark 与 GitHub Flavored Markdown（GFM）标准，并在此基础上扩展支持表格、KaTeX 数学公式、Mermaid / Vega / PlantUML 图表、上下标、脚注、以及 YAML / TOML / JSON 三种 Front matter，绝大多数 GitHub 上的 Markdown 文档都能正常渲染。

Linux 上的 AppImage 怎么集成到桌面环境？ AppImage 本质上无法“安装”，赋予可执行权限后直接运行即可。若要集成到桌面菜单，可以手动创建 desktop 文件（官网提供了示例 desktop 文件），或使用 AppImageLauncher 自动完成集成。Arch Linux 用户也可以通过 AUR 的 marktext-bin 包安装。

MarkText 会自动关联 .md 文件吗？支持哪些扩展名？ 在 Windows 上安装完成后，MarkText 会自动注册为 .md、.markdown、.mmd、.mdown、.mdtxt 和 .mdtext 六种文件类型的默认打开方式。

MarkText 如何安装？ #

Windows #

1. 下载与你的处理器架构匹配的安装包：绝大多数用户选择 marktext-win-x64-<version>-setup.exe，ARM64 设备（如骁龙 X 系列笔记本）选择 marktext-win-arm64-<version>-setup.exe。
2. 双击运行 .exe 文件，按照 NSIS 安装向导提示操作。
3. 安装程序为当前用户级安装，允许你自定义安装目录，并会自动创建开始菜单与桌面快捷方式。
4. 安装完成后，MarkText 会自动注册为 .md、.markdown、.mmd、.mdown、.mdtxt、.mdtext 文件的打开方式。
5. 如果你更喜欢免安装方式，官网也提供 Portable zip，解压到任意目录后直接运行 marktext.exe 即可（详见官网「Portable mode」文档）。

macOS #

1. 根据处理器选择镜像：Apple Silicon（M1/M2/M3/M4）下载 marktext-mac-arm64-<version>.dmg，Intel Mac 下载 marktext-mac-x64-<version>.dmg。
2. 打开 DMG 文件，将 MarkText 图标拖入「应用程序」（Applications）文件夹。
3. 由于构建暂未公证，首次启动可能触发 Gatekeeper 提示——右键点击应用图标并选择「打开」，确认一次后即可正常使用。
4. 也可以使用 Homebrew Cask 一键安装：

brew install --cask mark-text

Linux #

MarkText 提供五种 Linux 发行格式，多数用户推荐使用 AppImage：

1. AppImage（推荐）：下载后赋予可执行权限并运行，无需 root 权限，适配大多数发行版：

chmod +x marktext-<version>-x86_64.AppImage
./marktext-<version>-x86_64.AppImage

2. deb（Debian / Ubuntu / Linux Mint / Pop!_OS 等）：sudo apt install ./marktext-linux-<version>.deb
3. rpm（Fedora / RHEL / openSUSE 等）：sudo rpm -i marktext-linux-<version>.rpm
4. snap（Ubuntu 或任何启用 snap 的发行版）：sudo snap install marktext-linux-<version>.snap --dangerous --classic
5. tar.gz（便携版）：解压后运行其中的 marktext 二进制文件。
6. Arch Linux：可通过 AUR 安装 marktext-bin（如 yay -S marktext-bin），该包会自动安装 glibc、gtk3、nss、alsa-lib 等依赖。

校验下载完整性：所有发布产物都会附带 SHA-256 值，位于 SHA256SUMS.txt，可用 sha256sum -c SHA256SUMS.txt --ignore-missing 核验。

MarkText 如何卸载？ #

Windows #

1. 打开「设置 → 应用」，找到 MarkText 并选择卸载；
2. 或直接运行安装目录中自带的 Uninstall MarkText.exe。
3. 如需一并清除用户数据，可手动删除 MarkText 的应用程序数据目录。

macOS #

1. 打开「应用程序」文件夹，将 MarkText.app 拖入「废纸篓」；
2. 如需彻底清理，可另外删除用户数据目录 ~/Library/Application Support/marktext。

Linux #

按安装方式选择对应命令：

• deb 安装：sudo apt remove marktext
• rpm 安装：sudo rpm -e marktext
• snap 安装：sudo snap remove marktext
• AppImage / tar.gz：直接删除你解压或下载的文件即可；如果曾手动创建过 desktop 文件，建议一并删除，并清理用户配置目录 ~/.config/marktext。

如果你希望连用户设置、主题配置等数据一并清除，请手动删除 MarkText 的应用程序数据目录（具体路径见官网文档「Application data directory」一节）。