marktext/marktext · 上手攻略

• 仓库：marktext/marktext
• 链接：https://github.com/marktext/marktext
• 分类：tool, productivity, markdown
• 作者：Jay
• 更新：2026-07-08

这是什么

MarkText 是一款专注于速度与体验的开源 Markdown 编辑器，支持 Linux、macOS、Windows 三大平台。

它的核心理念是所见即所得（WYSIWYG）：左手写 Markdown，右手实时预览，无需切换视图，不需要学习额外的标记语法。界面简洁优雅，主打无干扰写作体验，底层基于 Electron + Vue.js，最新稳定版本为 v0.17.1（2026 年初）。

GitHub Stars 超过 58,000，社区活跃，是目前开源 Markdown 编辑器中口碑最好的选择之一。

解决什么问题

很多人写 Markdown 的痛点：

• Typora：曾经免费，但 v1.0 后开始收费，且跨平台体验不一致
• VS Code：太重，需要配置 Markdown All in One 插件才能舒服地写文档
• 其他编辑器：预览分屏、卡顿、主题丑、功能残缺

MarkText 的定位就是一款纯粹的 Markdown 写作工具：打开就用，不用配置，不用买License，界面好看，写作体验流畅。

快速安装

macOS

方式一：Homebrew（推荐）

brew install --cask mark-text

方式二：直接下载 - 去 GitHub Releases 下载 marktext-%version%.dmg - 拖入 Applications 即可

Windows

方式一：安装包（推荐） - 下载 marktext-setup-%version%.exe（Releases 页） - 运行安装向导，可选 per-user 或 machine-wide 安装

方式二：Chocolatey

choco install marktext

方式三：Winget

winget install marktext

Linux

AppImage（通用，推荐）

# 下载 AppImage
wget https://github.com/marktext/marktext/releases/latest/download/marktext.AppImage
chmod +x marktext.AppImage
./marktext.AppImage

其他包管理器：

# Arch Linux (AUR)
yay -S marktext

# snap
sudo snap install marktext

# Flatpak
flatpak install flathub com.marktext.MarkText

📌 Linux 上如果打不开，报 "MarkText 已崩溃"，通常是缺少依赖（如 libgconf-2-4），需要先装依赖： ```bash

Debian/Ubuntu

sudo apt install libgconf-2-4 libnotify4 libxkbfile1 libnss3 ```

核心用法

1. 编辑模式

切换方式：菜单栏 → View → Editing Mode

2. Markdown 规范支持

• ✅ CommonMark Spec（基础 Markdown 标准）
• ✅ GitHub Flavored Markdown（GFM）（表格、任务列表、代码高亮等）
• ✅ Pandoc Markdown（选择性支持，如脚注等）

3. 常用快捷键

4. 段落与行内样式快捷键

MarkText 支持类似 typora 的快捷方式：

• 输入 --- + 回车 → 水平分割线
• 输入 $$ + 回车 → 数学公式块（KaTeX）
• 输入 ``` + 回车 → 代码块
• 输入 --- 在一行 → <hr> 标签
• 选中文字后按 * / _ → 快速加粗/斜体

5. 导出功能

导出：菜单栏 → File → Export

6. 主题

内置主题（View → Themes）：

自定义主题放入 ~/.config/marktext/themes/ 目录（支持 .css 文件）。

7. 实时数学公式（KaTeX）

输入数学公式会自动渲染：

行内公式：$\int_0^\infty e^{-x^2} dx = \frac{\sqrt{\pi}}{2}$

公式块：
$$
\sum_{i=1}^n i = \frac{n(n+1)}{2}
$$

⚠️ KaTeX 支持需要编辑器能访问本地字体，网络离线环境下数学公式可能渲染不全（属 KaTeX 已知问题）。

8. Front Matter

MarkText 原生支持 YAML Front Matter（--- 包裹的元数据），适合配合 Hugo/Jekyll 等静态博客工具使用：

---
title: "My Article"
date: 2026-07-08
tags: ["markdown", "guide"]
---

典型适用场景

坑与注意

1. Electron 内存占用：相比 Typora，Electron 基础框架稍重，大文件（>1MB）可能有轻微卡顿；建议用 Focus Mode 避免同时渲染太多内容。
2. 代码高亮语言覆盖：MarkText 使用 Prism.js 做代码高亮，支持约 100+ 常用语言，但某些小众语言可能不识别，此时显示为纯文本。
3. Linux 下中文输入法：部分 Linux 发行版（如 Ubuntu 20.04）存在输入法（fcitx）与 Electron 的兼容问题，中文输入时选词框可能错位；新版 Electron 已改善，老系统建议用 XDG Desktop Portal 解决。
4. 文件保存不自动触发：MarkText 默认不监控外部文件变更，如果用其他编辑器同时打开同一文件，需要手动 reload（Cmd/Ctrl + Shift + P → "Reload"）。
5. 导出 PDF 样式依赖：PDF 导出使用编辑器当前主题，截图分享时请先切换到合适主题。
6. 无同步功能：MarkText 是纯本地编辑器，不支持 Notion/印象笔记式同步；适合本地文件管理，或配合 Git 管理文档版本。
7. macOS ARM64 兼容性：Apple Silicon Mac 上 MarkText 已有原生 ARM 版本（marktext-mac-arm64.dmg），选错版本会导致性能问题。

与同类对比

核心差异：MarkText 在"好看 + 免配置 + 免License"的三角里做到了最佳平衡，是 Typora 最合适的免费替代；缺点是无插件生态、不支持双链笔记。

一句话推荐结论

写 Markdown 就想安安静静写、不折腾、不买License——MarkText 是目前免费开源里体验最接近 Typora 的选择，打开就用、所见即所得，macOS / Windows / Linux 全平台覆盖，日常文档写作直接装。