说句实话现在写 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 上老版本 macOS10.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。Linuxdeb 包安装后通常在/opt/MarkText/resources/localesAppImage 则需要先解包再进行文件操作比较麻烦新手不推荐手动汉化。放置完成后重新启动 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_MODULEfcitx如果你的系统用的是 ibus 框架改成export GTK_IM_MODULEibus改好后再启动中文输入就恢复正常了。如果是在 macOS 上出现类似问题更新一下输入法设置看看系统版本是不是太旧一般就能解决。5.4 粘贴图片后图片不显示或没保存下来MarkText 支持直接粘贴剪贴板里的图片但这个功能有一个让人容易搞不懂的地方默认情况下图片的保存方式不是自动定的需要你在偏好设置里指定一个保存目录。如果你粘贴图片后预览区只出现一个空链接那么按下面步骤操作进入“偏好设置”—“图片”。在“保存图片至”设置项里选择一个清晰明确的目录比如assets文件夹。保存设置后再次粘贴图片MarkText 就会自动把图片保存到那个目录并在文档中插入正确的相对路径。我习惯在每个项目文件夹下都建一个assets子目录然后把图片保存路径指向它。这样整个项目复制到别处也不会出现图片失效的问题相当省心。5.5 导出 PDF 时中文变成乱码或方框这个问题我记不清帮几个朋友处理过了。MarkText 导出 PDF 时依赖的渲染引擎如果没有合适的字体支持中文就会变成一片小方块或者乱码。解决办法有两手准备在“偏好设置”—“通用”里把渲染字体改成系统已有的中文字体比如微软雅黑、思源黑体。如果导出后仍然乱码先导出 HTML再用浏览器打开并打印为 PDF。用这个曲线方案既能保留 Markdown 渲染效果又不会出现中文字体问题。6. 让 MarkText 更好用效率技巧与个性化配置6.1 快捷键是提高写作效率最快的途径MarkText 支持的快捷键和 Typora 高度相似如果你是 Typora 迁移过来的用户几乎可以无缝衔接。我最常用的几个Ctrl1到Ctrl6切换 1 到 6 级标题CtrlB加粗CtrlI斜体CtrlK插入链接CtrlShiftK插入代码块CtrlShiftI插入图片CtrlShift当行内代码真正让效率翻倍的是大纲模式。按CtrlShiftO打开大纲面板长文档结构一目了然点哪段跳哪段配合CtrlShiftX切换到源码模式来回操作非常顺手。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然后花两分钟把语言切换成中文再花十分钟把快捷键和主题调成自己习惯的样子。它的安装和汉化流程你回过头来看其实也就是这篇文章讲的这点事下载一个安装包、设置里选一下语言剩下的就是专心写内容。最后分享一个小技巧每次写完文档按CtrlS保存之后再顺手按一下CtrlShiftX切到源码模式看看有没有多余的空白行和未闭合的标记符号。这个小习惯能帮你提前避开一堆导出时的格式问题省下的时间可比你找补丁的时间多多了。