说句实话,现在写 Markdown 的编辑器多到数不过来,Typora 收费之后,一堆人到处找替代品,Obsidian 功能全但上手门槛不低,Joplin 又偏笔记管理。我前前后后试了一圈,最后长期留在主力位置的,反而是这款开源免费的MarkText。它最吸引人的就是那个“所见即所得”的沉浸式编辑体验,比 Typora 还更像 Typora,而且 2026 年的今天用起来依旧能打,完全不像一个停止更新的老项目。
这篇文章我直接给你把MarkText 下载、安装、汉化的完整流程理顺,包括 Windows、macOS、Linux 三种平台的安装包获取方式、汉化补丁的放置路径、以及我实际使用中踩过的坑和解决办法。不管你是刚接触 Markdown 的纯新手,还是想从 Typora 迁移过来的老用户,照着这篇走,十分钟之内就能把它跑起来,而且全程中文界面。
1. MarkText 是什么,为什么 2026 年还值得装
1.1 不是 Typora 平替,是另一种“所见即所得”
很多人第一次看到 MarkText 都会冒出同一个想法:这不是 Typora 的免费版吗?界面都是那种干干净净的单栏编辑,输入 Markdown 语法立刻实时渲染成排版效果。但实际上它俩的交互细节还是有明显差别的。
MarkText 的核心卖点有三个:一是纯本地编辑,你的笔记数据始终躺在自己硬盘上,不依赖任何云端服务器,隐私性天然有保障;二是全平台覆盖,Windows、macOS、Linux 三个系统都有官方安装包,不像某些编辑器只照顾 Windows 用户;三是零成本,完全开源免费,不用激活码,不用订阅制,没有“个人版”“专业版”的花式收费。
我用 MarkText 写技术博客、记会议纪要、整理学习笔记,前前后后写了上百篇,最满意的地方是它的大纲模式和源码模式切换非常顺滑。按下快捷键就能从编辑视图切到 Markdown 源代码视图,修改完再切回来,渲染结果保持不变,这在处理复杂表格的时候特别实用。
1.2 停止维护不是问题,稳定才是硬道理
这里我得提醒你一句实话:MarkText 的原作者确实在 0.16.1 版本之后就不再频繁更新了,整个项目进入了社区维护的慢节奏阶段。但这不代表它不能用,恰恰相反,它的核心功能非常稳定,就像一把用惯了的螺丝刀,虽然没有那么多花哨的新功能,但该拧的螺丝都能拧得动。
拿我最常用的几个场景举例:
- 写作时实时看到标题层级、加粗、链接的渲染效果,眼睛不累
- 粘贴图片后自动保存到本地指定目录,不会出现图片丢失
- 导出 HTML 和 PDF 的功能简单可靠,排版基本不乱
所以与其说这是“过气软件”,不如说它是经历过大浪淘沙后的实用工具。2026 年装它,你得到的是一个干净、高效、够用的 Markdown 编辑器。
2. 安装前必须知道的版本选择与系统要求
2.1 版本号该选哪个,别被各种渠道搞迷糊
MarkText 的版本号看起来挺简单,但下载的时候还是要注意区分。当前主流稳定版本是 v0.16.1,这也是社区公认的最稳定版本。市面上有些渠道会提供旧版本,比如 v0.15.x 甚至更早的 v0.14.x,如果你只是日常写作,直接用 v0.16.1 就好,不要贪多去追所谓的“最新测试版”。
另外,MarkText 的安装包分为两种格式:
- Windows 平台:分为
marktext-setup-x64.exe和marktext-x64.msi,前者是常见的安装向导格式,双击就能装;后者是 Windows 自带的 MSI 安装格式,适合企业批量部署。 - macOS 平台:后缀是
.dmg,双击后拖进 Applications 文件夹即可。 - Linux 平台:有
.AppImage、.deb、.rpm三种格式,分别对应不同发行版。
提示:下载安装包之前,先确认自己的系统是 64 位还是 32 位。现在绝大多数电脑都是 64 位系统,如果你的电脑特别老,注意看清楚安装包名称里的 x64 和 ia32 标识。
2.2 系统要求很宽松,但有一点要留意
MarkText 基于 Electron 框架开发,所以它对硬件的要求不算高。双核 CPU、4GB 内存的电脑就能流畅运行,哪怕是十几年前的办公电脑,用来处理几万字的 Markdown 文本也毫无压力。
但有一点容易踩坑:操作系统版本的兼容性。Windows 上,Win7 需要额外安装一些系统补丁才能正常启动;macOS 上,老版本 macOS(10.13 以下)可能无法打开 dmg 文件。如果你还在用老旧系统,建议先查一下 MarkText 的 GitHhub Release 页面,看支持的最低系统版本是多少。
下载安装包的时候,我推荐优先从 GitHub Releases 页面获取。如果访问 GitHub 不方便,也可以找一些知名的软件分发站,下载后对比一下文件的 SHA256 哈希值,确保文件完整、没有被篡改。
3. 三大平台安装实操详解
3.1 Windows 平台:从下载到桌面的完整流程
Windows 的安装过程最省心,但也不是单纯的“双击下一步”这么简单,我把每一步的要点写出来你做参考:
- 下载
marktext-setup-x64.exe安装包,放到桌面或者任意目录。 - 双击运行安装程序,这时候会弹出一个选择安装路径的窗口。建议不要安装在 C 盘系统盘,后续虽然不会产生多少缓存数据,但考虑到 D 盘空间更充裕,养成好习惯不亏。
- 一路点“下一步”,安装程序会提示选择是否创建桌面快捷方式和文件关联。我建议把“Markdown 文件关联”勾上,这样后续双击
.md文件就能直接用 MarkText 打开,省一步操作。 - 安装完成后,第一次启动会有一个“欢迎页”,选一下主题风格(白色、灰色、深色),这就进入主界面了。
有一个小细节值得提一下:如果你下载的是.msi格式的安装包,安装完成后软件不会出现在开始菜单的常用位置,需要自己去“所有程序”里找。所以个人用户我更推荐.exe格式。
安装完成后,默认界面是英文的。别急,汉化的步骤我放在后面第 4 节,那一步才是今天的重点。
3.2 macOS 平台:安全提示的处理方法
macOS 用户装 MarkText,流程跟大多数 Mac 软件一样:
- 下载
.dmg文件,双击打开。 - 把 MarkText 图标拖入 Applications 文件夹。
- 打开应用程序文件夹,双击 MarkText 启动。
但这里有一个“老朋友”一定会遇到的问题:启动时提示“无法打开,因为 Apple 无法检查其是否包含恶意软件”。原因很简单,MarkText 是开源软件,没有走 Mac App Store 的公证流程,而 macOS 默认只放行经过公证的应用。
解决办法也简单,打开“系统偏好设置”—“隐私与安全性”,在底部会让你选择“仍要打开”,点一下就能正常运行。
注意:如果系统版本比较新,可能在“隐私与安全性”里连“仍要打开”的选项都看不到。这时候需要打开终端,输入
sudo spctl --master-disable,先关闭默认的安全检查,安装完成后再用sudo spctl --master-enable恢复。这个命令只影响用 Ctrl+点击 打开应用的校验,对系统安全整体影响不大。
3.3 Linux 平台:AppImage 和 deb 两种玩法
Linux 用户装 MarkText,主要有两条路:
路线一:AppImage 版
- 下载
.AppImage文件。 - 给文件赋予执行权限:右键属性里勾选“允许作为程序执行”,或者在终端里跑
chmod +x MarkText-0.16.1-x86_64.AppImage。 - 双击运行,就能直接打开。
AppImage 的好处是免安装,一个文件拿过去就能用,适合不想往系统里塞一堆依赖的玩家。
路线二:deb 包
- 下载
.deb文件。 - 在终端执行
sudo dpkg -i marktext_0.16.1_amd64.deb。 - 如果有依赖报错,执行
sudo apt -f install自动修复。
装完之后,在应用程序列表里就能搜到 MarkText,点开使用即可。我自己日常用的是 Ubuntu + deb 包方式,稳定性和系统整合度都比 AppImage 高一些。
3.4 安装之后怎么验证是否正常
安装完成后,我习惯做三件事来验证安装是否成功:
- 打开软件,看能否正常出现空白编辑区;
- 新建一个
.md文件,输入# 你好,确认标题能实时渲染; - 在设置里切一下主题,确认界面刷新没有卡顿。
如果前面两步都没问题,那说明安装很顺利。接下来就可以进入汉化环节了。
4. MarkText 汉化全流程:从英文界面变身中文界面
4.1 先试试官方自带的语言切换功能
很多用户不知道,MarkText 其实内置了一套语言切换机制,并不是单纯依赖第三方汉化包。所以汉化的第一步,不是去网上找“汉化补丁”,而是先看看自己手头这版能不能直接切中文。
操作路径是:
- 打开 MarkText 主界面。
- 点击左侧边栏底部的“设置”图标(齿轮形状)。
- 在设置窗口的“General”分类下,找到“Language”选项。
- 下拉菜单里选择“简体中文”。
如果你在 Language 菜单里看到了中文选项,选它,界面会立刻变成全中文,汉化完成,就这么简单。
这是最干净、最稳妥的汉化方式,没有任何文件替换,也不会出现改错导致的乱码问题,所有用户都应该优先尝试这个方法。
4.2 手动放置语言包:解决没有中文选项的问题
问题来了:如果 Language 菜单里根本没有中文选项,怎么办?
这时候就需要手动放置语言包了。MarkText 的界面语言文件存放在程序安装目录下的resources/locales文件夹里。你需要的语言包文件通常是以类似zh.json或zh-cn.json的命名存在。如果某个版本的安装包没有附带这个文件,可以从社区找对应版本的语言包,手动放进去。
具体路径要分系统看:
- Windows:在安装目录下找
resources/locales文件夹,比如默认安装路径是D:\Program Files\MarkText\resources\locales。如果资源目录里没有暴露出来,注意看有没有app.asar文件——语言包可能在app.asar.unpacked文件夹下,需要先解开这个文件才能放语言包。 - macOS:右键点击“应用程序”里的 MarkText,选择“显示包内容”,然后进
Contents/Resources/locales。 - Linux:deb 包安装后通常在
/opt/MarkText/resources/locales,AppImage 则需要先解包再进行文件操作,比较麻烦,新手不推荐手动汉化。
放置完成后,重新启动 MarkText,在设置里的 Language 菜单中就能看到中文选项了。
4.3 使用第三方整合汉化版的注意事项
网上有一些“MarkText 汉化版”安装包,里面已经预置了中文语言。对这种版本,我的态度是可以用,但要谨慎。
使用第三方整合版之前,先确认两件事:
- 安装包来源可不可靠。能够提供语言包的社区通常也会一并发布校验信息,下载后对比一下文件哈希,能大大降低被植入恶意代码的风险。
- 版本号对不对。有些汉化补丁是针对特定版本制作的,你用 v0.15.x 的补丁去配 v0.16.1,界面会有一小部分翻译缺失,甚至可能直接导致软件打不开。
我的个人建议是:优先用官方原版 + 手动汉化。具体原因很简单,原版稳定性有保障,而手动汉化只需要放一个语言文件,操作难度并不比装软件高多少,但后续不会再碰见各种奇怪问题。
5. 真实使用中我踩过的坑:常见问题与排查思路
5.1 Windows 下双击没反应,启动失败怎么办
这是我遇到最多的问题,尤其是用.msi安装包装完之后,桌面快捷方式点下去,鼠标转两圈,软件就是不出来。
排查思路按顺序来:
- 打开任务管理器,看看进程列表里有没有
MarkText.exe。如果进程在,但窗口不显示,是窗口渲染方面的问题,这通常和显卡驱动有点关系;如果进程根本不在,说明程序启动阶段就失败了。 - 对
.exe安装包,试试点右键“以管理员身份运行”。Electron 应用在部分系统环境下需要管理员权限才能访问某些资源目录。 - 确认是否缺少微软常用运行库。MarkText 依赖一部分系统运行库,老系统或者精简版系统最容易出事。网上搜一下“微软常用运行库合集”,装上之后再启动,大概率能解决。
还有一个很不太容易往那想的原因:安装路径里有中文或特殊字符。早年间有用户把软件装在D:\软件\MarkText这类中文路径下,结果程序死活不启动。遇到这种情况,把安装目录改回全英文路径即可。
5.2 macOS 下提示“已损坏,无法打开”的真相与处置
很多 Mac 用户在网上下载 MarkText 后,会看到对话框提示“MarkText 已损坏,无法打开,你应该将它移到废纸篓”。
请记住,在这里“已损坏”并不代表安装包真的坏了,绝大多数时候是 macOS 的Gatekeeper 安全机制在拦截未经认证的应用。应对方法分两步:
- 打开“系统偏好设置”—“隐私与安全性”,看有没有“仍然打开”的按钮,有就直接点。
- 如果按钮不在,打开终端,执行:
sudo xattr -d com.apple.quarantine /Applications/MarkText.app这个命令是把下载文件的隔离标记去掉,执行完重新打开软件就能正常使用。这也是社区中最普及的解法。
5.3 中文输入法无法打字或光标跳动异常
MarkText 有一个比较知名的历史问题:在部分 Linux 桌面环境和老版 macOS 上,中文输入法无法正常上屏,要么拼音打完不能选字,要么打字后光标乱跳。
在 Windows 上我用的搜狗输入法、微软拼音,都没出过问题。Linux 上我遇到过 fcitx 输入法在 MarkText 里失效的坑,解决办法是修改启动脚本,加入一行环境变量设置:
export GTK_IM_MODULE=fcitx如果你的系统用的是 ibus 框架,改成:
export GTK_IM_MODULE=ibus改好后再启动,中文输入就恢复正常了。如果是在 macOS 上出现类似问题,更新一下输入法设置,看看系统版本是不是太旧,一般就能解决。
5.4 粘贴图片后图片不显示或没保存下来
MarkText 支持直接粘贴剪贴板里的图片,但这个功能有一个让人容易搞不懂的地方:默认情况下,图片的保存方式不是自动定的,需要你在偏好设置里指定一个保存目录。
如果你粘贴图片后,预览区只出现一个空链接,那么按下面步骤操作:
- 进入“偏好设置”—“图片”。
- 在“保存图片至”设置项里,选择一个清晰明确的目录,比如
assets文件夹。 - 保存设置后,再次粘贴图片,MarkText 就会自动把图片保存到那个目录,并在文档中插入正确的相对路径。
我习惯在每个项目文件夹下都建一个assets子目录,然后把图片保存路径指向它。这样整个项目复制到别处,也不会出现图片失效的问题,相当省心。
5.5 导出 PDF 时中文变成乱码或方框
这个问题我记不清帮几个朋友处理过了。MarkText 导出 PDF 时,依赖的渲染引擎如果没有合适的字体支持,中文就会变成一片小方块或者乱码。
解决办法有两手准备:
- 在“偏好设置”—“通用”里,把渲染字体改成系统已有的中文字体,比如微软雅黑、思源黑体。
- 如果导出后仍然乱码,先导出 HTML,再用浏览器打开并打印为 PDF。用这个曲线方案,既能保留 Markdown 渲染效果,又不会出现中文字体问题。
6. 让 MarkText 更好用:效率技巧与个性化配置
6.1 快捷键是提高写作效率最快的途径
MarkText 支持的快捷键和 Typora 高度相似,如果你是 Typora 迁移过来的用户,几乎可以无缝衔接。我最常用的几个:
Ctrl+1到Ctrl+6:切换 1 到 6 级标题Ctrl+B:加粗Ctrl+I:斜体Ctrl+K:插入链接Ctrl+Shift+K:插入代码块Ctrl+Shift+I:插入图片Ctrl+Shift+当行内代码
真正让效率翻倍的是大纲模式。按Ctrl+Shift+O打开大纲面板,长文档结构一目了然,点哪段跳哪段,配合Ctrl+Shift+X切换到源码模式,来回操作非常顺手。
6.2 主题配色与自定义 CSS:让编辑器有自己的味道
MarkText 内置了几套主题,包括经典的白色、灰色、暗黑色(Dark)和 One Dark。我常年用暗黑主题,晚上码字对眼睛友好。给第一次装好的朋友一个建议:去“偏好设置”—“主题”里,直接把“Dark”设为默认主题,再开一个“自动跟随系统”也行。
如果你连内置主题还不满足,MarkText 支持自定义 CSS。在偏好设置的“编辑器”分类里,有“自定义字体”和“自定义 CSS”的入口。我自己调过一小段 CSS,把正文行距调大一点、标题颜色调成偏蓝的色调,写出来的文档在排版质感上立刻不一样。
h1, h2, h3 { color: #2c6fbb; } body { font-family: "Source Han Sans SC", "Microsoft YaHei", sans-serif; line-height: 1.8; }保存之后,预览区域会即时更新,鼓捣起来相当有成就感。
6.3 用 MarkText 搭建本地写作流水线
对于写博客、写日记、写工作日志的人来说,MarkText 的本地化模式带来的不仅是隐私,还有高度可控的文件管理方式。所有文档就是一个个朴素的.md文件,配合 Git 可以做版本管理,配合坚果云、Dropbox 可以做多端同步,完全没有被某个私有笔记格式锁死的问题。
我的工作流是这样的:
- 每次写作前,在常用目录新建一个
.md文件,文件名用日期加主题,例如2026-02-11-marktext-guide.md。 - 写完后用 MarkText 导出 HTML 或 PDF,用于发布或存档。
- 定期把这个目录同步到网盘,做到异地备份。
这套流程就像在自己的硬盘上建了一座小型内容工厂,简单、透明、可控。
6.4 如果不想装客户端,浏览器版能应急吗
经常有人问有没有网页版 MarkText。明确回答:没有官方网页版。MarkText 是纯桌面应用,开发团队从未推出过 Web 版本,所以别去找什么“MarkText 在线使用”的站点,那些通常是用别的编辑器套了个壳。
遇到没有电脑在身边的时候怎么办?我的应急方案是使用任意在线 Markdown 编辑器,比如 GitHub 自带的在线编辑,写完复制回 MarkText 做最终排版。整个过程数据都是自己把控的,核心编辑体验还是在 MarkText 里完成。
7. 个人实操经验:一个老用户的最终建议
用 MarkText 这几年,我最大的体会是:工具不在多,顺手最重要。在很多程序员和写作者追求“全家桶”、“一体化”的风气下,MarkText 这种小而干净的编辑器反而显得格外难得。它不会自动替你整理笔记进行分类,也不会用花哨的插件提醒消息分散你的注意力,它就是安安静静地把你写的 Markdown 文本渲染成好看的排版,仅此而已。
如果你只是想在 2026 年找一个稳定可靠的 Markdown 写作工具,我真心建议你装一个原版的 MarkText,然后花两分钟把语言切换成中文,再花十分钟把快捷键和主题调成自己习惯的样子。它的安装和汉化流程,你回过头来看,其实也就是这篇文章讲的这点事,下载一个安装包、设置里选一下语言,剩下的就是专心写内容。
最后分享一个小技巧:每次写完文档,按Ctrl+S保存之后,再顺手按一下Ctrl+Shift+X切到源码模式看看,有没有多余的空白行和未闭合的标记符号。这个小习惯能帮你提前避开一堆导出时的格式问题,省下的时间可比你找补丁的时间多多了。