说起 Markdown 编辑器很多人第一反应是 Typora。我也是从 Typora 开始用的但 2021 年它从免费转向收费之后我一直在找一款能平替的开源软件。MarkText 是我当时试了一圈之后留下的答案免费、开源、跨平台界面干净得像一张白纸写起来几乎没有存在感。这篇文章不打算给你念官方文档而是从我实际用了两年多的角度把 MarkText 的下载安装、中文设置、日常写作体验、导出 PDF 和 Word 的完整流程以及我踩过的坑一次讲清楚。如果你正在为“用哪款 Markdown 编辑器”纠结或者已经在用 MarkText 但有些功能没摸透这篇文章应该对你有用。1. 从 Typora 收费到 MarkText一个开源 Markdown 编辑器的定位1.1 Typora 付费之后我的迁移路线我记得 Typora 宣布 1.0 开始收费的时候不少人是直接下单买断的毕竟 89 元买一个省心的编辑器不算贵。但也有很多学生、刚工作的朋友以及只是偶尔写点东西的轻量用户觉得没必要为“一个写文字的软件”付费。于是那段时间各种替代品被反复拿出来对比VS Code 加一堆插件、语雀、Notion、Obsidian……它们都很好但都有一个问题——要么是需要搭环境要么是打开之后满屏的面板和按钮让人没法专心写字。VS Code 的 Markdown 插件生态确实强但分栏预览和实时渲染之间总隔着一段距离而且编辑器本体是为代码设计的代码文件夹、终端、调试面板都挤在旁边写文章时容易分心。语雀和 Notion 功能丰富但内容默认放在云端换网络、换账号的时候总有点不顺手而且它们更适合做知识库而不是单纯的“写一个 md 文件”。Obsidian 的双链和插件玩法很吸引人可学习成本不低本质上它更接近笔记库而非纯粹的编辑器。我自己的需求其实特别简单打开就能写实时看到排版结果写完的 Markdown 文件可以直接丢到博客里用。MarkText 恰好切中了这个点。它是用 Electron 做的桌面应用支持 Windows、macOS、Linux界面极简主窗口就是一个编辑区没有多余的边栏。输入 Markdown 语法时文字会即时渲染成标题、列表、引用块这种“所见即所得”的体验和 Typora 非常接近。GitHub 上 Star 数也已经接近五万在同类编辑器里排得很靠前社区活跃度一直不错。1.2 MarkText 的核心特性与适用人群MarkText 的定位很清楚它就是一个纯粹的本地 Markdown 编辑器不是笔记系统也不是知识库。它的主要特性包括GFMGitHub Flavored Markdown语法支持、代码块高亮、LaTeX 数学公式、表格、任务列表、目录大纲、多种主题以及我最常用的一个功能——直接从剪贴板粘贴截图到文档中图片会自动保存到本地。这里要特别说一句“适合谁”。我认为有四类人用 MarkText 会很舒服写技术博客的人因为最终发布的格式就是 Markdown本地写了直接上传需要整理学习笔记的学生Markdown 比 Word 更轻又比纯文本有结构工作中经常写文档、但不依赖复杂排版工具的人以及有开源偏好、希望软件本身可以审查、可以自由分发的用户。反过来如果你需要多人实时协作需要文档和云端数据库深度绑定或者需要像 Word 那样做精细的打印排版MarkText 就帮不上忙了。它有意识地没做这些事这一点反而让它的界面和逻辑都相当克制不会像一个“大而全”的套件那样打扰你。2. 安装与中文设置的完整流程Windows、macOS、Linux 各有各的坑2.1 从哪里下载、怎么选版本MarkText 的官方下载渠道是 GitHub 的 Releases 页面搜索 marktext 仓库就能找到。进入之后不要看花眼核心原则是选择最新的正式版release而不是 nightly 或 dev 构建版因为后者通常有未修复的已知问题。以 Windows 为例页面里通常会有 exe 安装包和 zip 便携版两个选择macOS 给的是 dmg 镜像Linux 则提供 AppImage、deb、rpm 三种格式。这里有一个很多新手忽略的点如果只是在自己电脑上装来写东西选安装版最省心如果你经常在不同电脑之间切换比如公司电脑、家里电脑、甚至公共电脑那便携版会方便得多——解压之后整个目录拷进 U 盘或网盘到哪都能打开配置和文档都在一个文件夹里。我自己的做法是 U 盘里放一份 Windows 便携版里面所有配置都已经调好插上就能用。下载时还建议看一眼版本号旁边的发布时间。MarkText 的项目维护节奏不算快挑一个发布了比较久、大家反馈稳定的版本比追最新版本更稳妥。如果你看到“Pre-release”字样的版本除非想尝鲜否则没必要碰。2.2 各平台安装的差异化操作Windows 下双击 exe 一路下一步即可Win10 和 Win11 都运行得很好。较旧的 Windows 系统如果打开报错通常是缺 VC 运行库装上对应版本就好。如果你选的是便携版解压后直接运行 MarkText.exe 就行不需要管理员权限绿色软件这点很省心。macOS 下安装 dmg 后把程序拖进 Applications 即可但很多朋友会遇到“已损坏无法打开”的提示——这不是安装包坏了而是系统的 Gatekeeper 拦住了未签名应用。到“系统设置-隐私与安全性”里选择仍要打开或者直接对应用执行 xattr -cr /Applications/MarkText.app 解锁就能正常启动。这个命令的本质是去掉文件上的隔离属性属于 macOS 安装未签名应用的常规操作。Linux 下最省事的是 AppImage先下载文件然后打开终端执行 chmod x MarkText-xxx.AppImage再 ./MarkText-xxx.AppImage 运行。如果你用 Debian/Ubuntu 系也可以下载 deb 包用 sudo dpkg -i 安装。装完如果没有托盘图标或者报缺少依赖一般跑一下 sudo apt --fix-broken install 把依赖补全就正常了。在 Linux 上还容易遇到一个问题默认字体渲染中文时偏细看着不舒服后面我会讲怎么调。2.3 中文语言包为什么下拉框里可能没有简体中文“marktext 怎么设置中文”是很多人搜的关键词大家下载后的默认界面是英文。正确路径是打开 File - Preferences或者直接按快捷键 Ctrl/Cmd , 进入设置找到 General 选项卡里面有一个 Language 下拉框。正常情况下下拉框里能看到简体中文zh-Hans选择后重启程序就变成中文界面了。但会有一个很烦的情况某些版本的下拉框里根本没有中文选项只有默认的 English。这通常是因为部分构建版本没有完整打包语言资源。解决办法是手动补语言包到 MarkText 官方仓库的 i18n 目录下找到 zh-Hans.json 语言文件下载后放到一个独立文件夹里比如 ~/.marktext/languages。然后在设置界面的 Language 区域找到“选择语言包文件夹”或类似的按钮选中这个文件夹MarkText 就会加载里面的语言包重启后再切换语言即可。这里要提醒一下MarkText 的中文语言包是社区贡献的翻译版本更新后可能出现部分界面中英混杂这是很正常的。另外设置成中文后软件的菜单、设置页、右键菜单会变成中文但窗口标题和部分插件相关文案可能仍是英文不影响使用。3. 写作体验拆解实时渲染、快捷键与最折磨人的 Markdown 细节3.1 三种编辑模式对应三种写作节奏MarkText 虽然是所见即所得编辑器但它并不强制只能看到渲染后的效果。在窗口右下角或 View 菜单里可以切换三种编辑模式。Source Code 模式展示的是原汁原味的 Markdown 源码适合调整复杂语法或处理大文件Typewriter 模式会让当前编辑的行始终停留在屏幕中央适合一口气写长文Focus 模式会把当前段落高亮显示其他内容淡化减少视觉干扰适合需要集中注意力的场景。我实际使用中最常待的是默认的即时渲染模式也就是 Typora 那种“写完一个换行符文本瞬间变成标题/列表/粗体”的状态。这个模式有个很关键的好处你几乎不需要算 Markdown 语法有没有写对眼睛看到的即最终效果。如果打开一个没有格式的纯文本文件MarkText 会保持普通文本状态只有输入 Markdown 语法之后才触发渲染。这种克制让“写”和“排版”两件事被拆开了专注写作时完全可以忽略格式写完再统一调样式。3.2 常用快捷键表直接抄就行MarkText 把绝大多数格式操作都做成了快捷键覆盖新手不需要背语法也能打出一篇带格式的文章。下面这几个是我每天都在用的功能快捷键加粗Ctrl/Cmd B斜体Ctrl/Cmd I插入链接Ctrl/Cmd K保存Ctrl/Cmd S查找替换Ctrl/Cmd F注意MarkText 不同小版本的快捷键略有差异最靠谱的确认方式是看菜单栏里每个功能后边标注的按键提示。看到快捷键表之后我建议直接写一页测试文档把标题、无序列表、图片、表格、引用、代码块、任务列表统统敲一遍感受一下触发格式后 MarkText 是怎样自动补全语法的。比如输入 “ ” 会自动变成引用块输入 “- ” 会自动变成无序列表输入 “” 后回车会自动生成代码块这些贴心的小动作用熟了之后会非常顺手。3.3 换行、表格、图片粘贴Markdown 新手最容易卡住的几个点换行这个问题被很多人搜也是新手最容易懵的地方。在标准 Markdown 语法里段落之间必须空一行否则两行文字会被拼成一个段落如果只想“软换行”而不产生空行间距则需要敲两个空格再回车。MarkText 做得比较人性化直接按回车是开启新段落按 Shift Enter 是软换行后者在诗歌、地址、连续注释等场景里非常常用。搞清楚这两个键换行混乱的问题基本就解决了。表格方面最省事的方式不是手写管道符和减号而是在 MarkText 里通过右键菜单或者工具栏插入表格弹出的面板可以直接指定行数和列数。插入后点击表格单元格就能直接编辑MarkText 会自动帮你补全和对齐管道符省去了手写大段竖线的枯燥。如果你从 Excel 或网页里复制一个现成表格MarkText 并不会自动把它转换成 Markdown 表格。我自己的处理习惯是先用在线表格转 Markdown 工具转换成文本再粘贴进来速度也很快。图片粘贴是我选择 MarkText 的原因之一。从浏览器截图、从微信聊天记录复制图片到 MarkText 里按 Ctrl/Cmd V图片会立刻出现在光标位置同时自动保存到文档同级的 assets 文件夹里。默认图片路径可以在设置里改我建议保持相对路径方便整个文件夹打包上传到博客或网盘。如果在多篇文章里混着贴图最后容易找不到图片归属这个问题放到第 5 章细说。4. 导出 PDF 与文档流转MarkText 不是终点格式转换才是日常4.1 MarkText 内置导出 PDF 的局限与替代方案用 MarkText 写完后最常见的需求是导出 PDF。直接在“文件-导出-PDF”里生成简单场景完全够用但它的排版选项很少页边距、页眉页脚、纸张大小都不方便精细控制。如果想要一份打印出来更好看的 PDF我更推荐走另一条路Ctrl/Cmd P 调出系统打印窗口打印机选择“另存为 PDF”然后在更多设置里把页边距改成自己需要的数值并且勾选“背景图形”。这个“背景图形”选项很关键不勾的话代码块和引用块的底色会丢导出的 PDF 视觉上会很干瘪。用打印方式导出你还能在预览窗口里看到每一页的分页情况随时调整缩放比例。相比内置导出这种方式的可控性强很多我后来基本只用打印导出。这里还要解答一个在 VS Code 用户群里经常出现的问题把 Markdown 导出为 PDF 时被提示需要下载 princexmlPrince。这是 VS Code 的 Markdown PDF 插件在调用 Prince 做排版引擎跟你装了哪个 Markdown 编辑器无关属于该插件的一个依赖。解决方式是在 Prince 官网下载对应操作系统的免费版本并完成安装再重启 VS Code插件就能正常导出。搞清楚这个依赖链之后再遇到类似的“导出缺依赖”提示就不会慌了。4.2 用 Pandoc 把 Markdown 变成 Word 文档MarkText 自身的导出菜单里其实也有 Worddocx这个选项但它依赖一个外部命令行工具 Pandoc。如果你没装 Pandoc点击导出 Word 会发现按钮是灰的或者弹错误提示。安装 Pandoc 很简单Windows 可以用 winget install pandocmacOS 用 brew install pandocLinux 在终端执行 sudo apt install pandoc。装完重启 MarkText导出 Word 就能正常工作了。如果你愿意多接触一点命令行Pandoc 能做的事情远不止导出 docx。最常用的工作流是pandoc 我的文章.md -o 我的文章.docx一条命令直接把 Markdown 变成 Word。配合模板文件还能控制标题字体、正文字号、行距这些 Word 排版细节。这个流程同样可以批量跑在终端里写个循环把整个目录的 Markdown 文件一次性转成 Word对需要定期交文档的人来说能省下大把时间。如果你的场景里还要接更多自动化也可以把 Pandoc 放进脚本、CI 流程或者各类工作流服务里配合定时任务或 API 触发拼出一条 Markdown 转 Word 的自动流水线。核心思路就是先有一个稳定的转换引擎再在外面套一层自动化外壳。4.3 关于 Docx/PDF 反向转 Markdown 的几个思路文档流转不只有 Markdown 转出去还有别的格式转进来。把 Word 转成 Markdown最简单的办法还是 Pandocpandoc 原有文档.docx -o 输出文档.md转换完成后再用 MarkText 打开标题、列表、粗斜体这些基础格式都能保留。我自己实测下来纯文字、基础格式的 docx 转换效果很好但带有大量文本框、复杂表格和页眉页脚的文档转换后会出现结构错位需要人工修整。PDF 反向转 Markdown 就复杂一些因为 PDF 本身是定位排版格式没有结构概念。如果只是提取文字很多在线 PDF 转文本工具就能完成任务但如果你希望把层级标题、段落序号也保留下来就得依靠带版面分析能力的开源解析项目。这类工具在应对结构规整、由 Word 生成的 PDF 时效果不错但在面对扫描件、多栏排版、复杂嵌套表格时仍然会有乱序和错位。我的经验是PDF 转 Markdown 更适合用“辅助阅读”的心态去用而不是期待百分百无损还原。转换结果先当草稿人工校对一遍再进 MarkText 编辑。如果你是做研究、论文阅读这类经常和 PDF 打交道的场景把转换工具和 MarkText 串在一起用会比在 PDF 阅读器里做笔记方便得多。5. 长期使用后我想告诉你的几个坑与技巧5.1 大文档卡顿的处理思路MarkText 是基于 Electron 的应用这类应用的通病是内存占用偏高。平时写两三千字的文章毫无压力但当文档膨胀到几万字、里面还塞了二三十张高清截图时滚动和输入的延迟就会变得明显。我的应对方法是长文档写作时把视图切到 Source Code 模式输入响应会快一截图片提前压缩到不超过 1MB实在需要写超长文档我会拆成多个子文件最后用 Pandoc 合并。这个思路对 Typora、Obsidian 同样适用。还有一个容易被忽略的点MarkText 的项目维护节奏并不算快我自己用下来0.17 之后的版本更新明显放缓了。也就是说如果你遇到一个棘手的 Bug可能很长一段时间都没人修。所以我的建议是不要因为“开源”就放松警惕重要文档用 Git 或网盘做好版本管理写完后定期导出备份。工具可以换数据不能丢。5.2 图片管理相对路径与 assets 目录的正确姿势前面提到 MarkText 粘贴图片时默认存放在当前文档同级的 assets 目录这个设计很多人觉得方便但也埋着一个坑如果多篇文章共用一个全局资源目录时间长了根本分不清哪张图属于哪篇文章。我自己的规范是每个文档目录都自给自足结构像这样article-1/ index.md assets/ pic-a.png pic-b.png这样整个文件夹拷到任何位置MarkText 打开后图片都还在。需要发布到博客时再把 assets 目录里的图片批量上传到图床用编辑器里的全局查找替换把路径改成图床地址就行。如果直接用网盘同步整个工作目录这种结构也能避免很多文件冲突。还有一个同文件名覆盖的坑不同文章各自截图后很容易出现两张名字相同的图片分别放在不同目录里就没问题但如果混在一个 assets 下后贴的图会把先贴的覆盖掉等发现时已经不好找回。分开目录存放是成本最低的规避方案。5.3 当我把它和 Typora、VS Code 放一起比用久了之后难免会把 MarkText 和同类工具放在一起对比我给不同朋友的建议也不太一样。对比维度MarkTextTyporaVS Code 插件价格免费开源89 元买断免费开源实时渲染支持支持需插件配合界面简洁度很高很高一般导出 PDF 精细度基础较好需要配置插件生态几乎没有较少非常丰富运行流畅度中等中等较好适合人群学生、轻量写作愿意为体验付费者程序员、多任务处理者如果你的需求是“打开就写、写完就发”MarkText 在免费工具里几乎是体验最接近 Typora 的选择。如果愿意付费Typora 的导出自定义和一些细节打磨确实更成熟。而如果你本身就在用 VS Code 写代码顺手装个 Markdown 插件其实也能覆盖日常写作需求只是多窗格切换没有 MarkText 这么沉浸。最后说点掏心窝的话。工具这东西从来都不是越多越好也不是越贵越好。MarkText 陪我写完了好几年的技术博客和课堂笔记我已经习惯把便携版放在 U 盘里走到任何一台电脑前插上就能接着写。它不花哨偶尔也会有小脾气但它把“写 Markdown”这件事做到了足够简单简单到让我忘记编辑器的存在。如果你正在寻找一个免费、干净、跨平台的 Markdown 编辑器装好之后认真写作一天感受一下它会不会让你忘记自己是在用编辑器。至少我是这样留下来的。