最近总有朋友问我:Typora 收费之后,到底还有没有能打的免费替代品?毕竟 Markdown 写作已经成为技术文档、笔记整理、博客发布的基本功,编辑器选不好,写东西的欲望都减半。今天要聊的 mdput,就是我在这个背景下挖到的一款免费轻量 Markdown 编辑器。前前后后我用了两三周,写技术博客、整理接口文档、做本地笔记都试过一遍,可以说它确实有资格被叫做“Typora 平替”。这篇文章我会从设计思路、安装配置、核心功能、性能实测、常见坑位五个角度完整拆一遍,尽量把适合谁用、不适合谁用也讲明白,免得你下了又删、删了又下。
mdput 不是那种上来就给你塞一堆面板、一堆按钮的“重型编辑器”,它的核心体验跟 Typora 非常接近:打开就是空白页面,直接输入 Markdown 语法,所见即所得地实时渲染。同时它体积小、启动快、跨平台,Windows、macOS、Linux 都能跑。我个人的评价是:如果你只是拿 Markdown 写写博客、记记笔记、维护一下 README,mdput 完全够用,甚至在某些体验上比 Typora 更顺手;但如果你指望它像 VSCode 那样长出插件生态、远程开发、代码调试能力,那它本质上就不是这个路子。下面我从实际出发,把这款编辑器的方方面面展开聊一聊。
1. 整体设计与思路拆解:为什么“平替”这件事能成立
1.1 Typora 用户的核心痛点与 mdput 的机会
先说背景。Typora 曾经是无数人第一次接触 Markdown 编辑器时用的工具,因为它把“源码编辑”和“实时预览”合并成了一个窗口,打字即排版,体验太流畅了。但后来 Typora 转为收费,虽然是一次买断制也不算贵,可对很多学生党、业余写作者来说,这个费用就会成为劝退点。再加上部分老版本在某些系统上装完以后弹窗提醒、保存受限,导致用户寻找免费替代品的需求暴涨。mdput 能在这个时间点冒头,靠的就是一件事:把“免费”和“流畅”同时做到位。
我所说的“免费”不只是价格为零,还包括没有任何订阅陷阱、没有任何功能阉割、不会用几天就让你开会员。而“流畅”则指启动快、渲染顺、打字不卡顿。市面上一堆开源编辑器,功能倒是很多,但往往启动需要两三秒,打开一个 100 行的文档还要转圈,这种“重量感”对 Markdown 写作来说是致命的。mdput 的思路就简单粗暴:我只要把核心链路做到极致,剩下的一切从简。
1.2 mdput 的定位取舍:轻量不等于简陋
我用过一段时间之后发现,mdput 在“轻量”和“够用”之间找了一个比较舒服的平衡点。它没有把界面做成极端的毛坯房:左侧可以展开文件树,顶部有菜单栏,编辑区的右键菜单也保留完整。但你没有看到的功能,比如插件系统、终端面板、任务管理、复杂设置项,它统统没做。这种取舍对普通 Markdown 写作场景其实是合理的,界面越干净,注意力就越容易集中在内容上,你打开它的目标就是“写”,而不是“折腾编辑器”。
跟同类工具横向对比会更清楚。Mark Text 也是开源免费的所见即所得编辑器,但它的更新节奏不稳定,某些系统上中文输入法会出现丢字问题;Zettlr 偏学术笔记场景,功能非常多,学习成本也高;Obsidian 则强在双链和插件生态,但它文件组织方式更深,上手门槛并不比 Typora 低。mdput 的定位是站在这些工具中间的:你不用学任何新概念,打开就写,写完就导出,像极了 Typora 早期那种“无感”的状态。
1.3 与 Typora 的核心功能对比
我整理了一份两者在核心维度上的对比,我个人实测下来的感受也写在里面:
| 维度 | Typora | mdput | 个人体验备注 |
|---|---|---|---|
| 价格 | 买断制收费 | 完全免费,开源 | 免费这一点对大多数用户是决定性差异 |
| 实时渲染 | 优秀,打字即排版 | 优秀,渲染延迟感知不到 | 两者差异很小,mdput 在长文档下偶尔略慢 |
| 界面风格 | 极简,主题丰富 | 极简,内置多种主题 | 都支持自定义 CSS,习惯 Typora 的能无缝迁移 |
| 导出 | PDF、HTML、图片等 | PDF、HTML、图片等 | 导出方式不同,但覆盖日常写作足够 |
| 图床支持 | 需要配置外部图床 | 支持本地、自定义图床 | 明确了“所见即所得”的逻辑,后续细说 |
| 表格编辑 | 有表格辅助工具 | 有基础表格编辑辅助 | 两者都别指望超过 Excel,但顺手程度差不多 |
| 扩展生态 | 插件能力有限 | 暂无插件生态 | 如果必须靠插件,请直接选 VSCode |
| 启动速度 | 快 | 更快 | 实测冷启动差 0.3-0.5 秒左右 |
表格看下来你会发现,mdput 并不是每个维度都赢了,但在“免费”和“基础体验”这两条主线上,它守得非常好。对大多数人来说,Typora 里 80% 的日常操作在 mdput 里都能找到对应位置,真正会让人觉得“缺失”的其实是那些长尾的、不常用的功能,而这部分我后面会专门讲。
2. 环境准备与首次上手:从下载到写出第一篇文档
2.1 下载、安装与版本选择
mdput 提供 Windows、macOS、Linux 三个平台的安装包,你直接去官方仓库或官网下载对应版本即可。Windows 下有安装版和免安装压缩包两种,我个人的习惯是:公司电脑用免安装版,不污染系统注册表;个人电脑用安装版,方便双击文件直接关联打开 .md 文件。macOS 用户注意区分 Intel 芯片和 Apple Silicon 芯片的版本,下错架构虽然也能用,但性能会打折扣;Linux 用户则建议优先选择 AppImage 或 deb 包。
首次打开,它会弹一个设置向导,让你选择编辑器的主题风格、默认字体、是否打开自动保存。这里我建议所有新手直接打开自动保存,不要问为什么,Markdown 写长文档时不崩溃比什么都重要。主题方面默认的黑白风格其实已经够用,如果你是从 Typora 迁移过来的,我建议直接切换到“GitHub”主题,渲染风格和 GitHub 网页端非常接近,代码块、引用块的观感都更舒服。
2.2 界面布局与关键菜单
mdput 的界面结构非常直白:菜单栏在顶部,左侧是可选的文件树面板,中间是编辑区,底部是状态栏。按Ctrl + B可以隐藏左侧文件树,让编辑区占据整个窗口;状态栏会显示当前的文档字数、光标所在行和列,以及一个轻量的格式提示符。对写作者来说,这个状态栏信息非常实用,尤其是写技术文档需要控制篇幅时,不用手动复制到 Word 里看页数。
菜单栏里最常用的是“文件”“编辑”“视图”三个菜单。“视图”菜单里可以切换编辑模式:实时渲染模式是默认的,适合写正文;源码模式则把所有排版隐藏,适合调整 Markdown 标记细节或批量替换文本。还有一个“专注模式”,打开后会把当前段落高亮,其他内容变暗,这个功能对写长文章时集中注意力帮助很大,我基本每天都会用。
2.3 我最推荐的基础配置参数
进入设置面板之后,有几个参数值得优先调,它们对日常写作体验影响巨大:
- 字体与字号:建议选择系统等宽字体,中英文混排更协调。我个人常用“Sarasa Mono SC”这类中外文等宽字体,代码块和正文的观感都稳定。
- 行宽:默认可能是较宽的行宽,对长段落来说其实容易读串行。我习惯把编辑区行宽设定在 860px 左右,和人眼的自然阅读宽度接近。
- 自动保存间隔:默认可能是每分钟一次,建议缩短到 30 秒。如果你经常在写博客时打开几十个标签页,一旦系统崩溃,这个设置能救回不少内容。
- 文件扩展名关联:如果你打算用它打开 .markdown、.mdown、.txt 这些文件,可以在设置里手动关联,默认只关联 .md,很容易漏。
这些配置一次性调好,之后基本不需要再碰设置项。好的编辑器就应该是“设一次,忘半年”,让你把注意力放回内容本身。
3. 核心功能与实操细节:Markdown 写作的关键环节
3.1 Markdown 语法支持:覆盖面足够日常使用
mdput 对标准 Markdown 语法的支持是完整的,标题、加粗、斜体、行内代码、代码块、引用、链接、图片、分割线、无序列表、有序列表、任务列表这些基础项全都支持,渲染效果和 Typora 保持在同一水准上。更复杂的语法如表格、脚注、删除线、上下标它也能处理。我在写技术文档时最担心的就是表格渲染:很多轻量编辑器处理复杂表格会错位,mdput 实测下来表现不错,列宽会根据内容自动调整,而且支持通过右键菜单在表格内插入行列、删除行列,不需要手工修改管道符。
此外,mdput 内置了对 Mermaid 图表的支持。在代码块中输入mermaid语言标识,里面写流程图、时序图、甘特图,预览区会直接渲染出图。这点对技术作者来说价值很大,接口时序图、业务流程说明、架构图都可以直接用文字描述生成,不用再切到 draw.io 或 ProcessOn 重新画。美中不足的是 Mermaid 版本可能不是最新,个别新语法节点会提示不支持,但基础用法完全够用。
3.2 实时渲染与源码模式:什么时候该切,怎么切
实时渲染模式是默认选项,也是我日常写文章的主要模式。它的好处是所见即所得,遇到格式问题当场就能发现。但实时渲染也会带来一个麻烦:当 Markdown 源码里出现错误的语法标记,或者在复制粘贴外部文本时混入了奇怪的 HTML 片段,你会很难定位问题。这时候切换成源码模式就很有必要。在源码模式下,所有标记原形毕露,你就能找到多出来的一个星号、少掉的右括号、或者被粘贴进来的无用<div>。
切到源码模式还可以做一件事:批量调整格式。比如把某个关键词统一加粗,或者把一堆行内代码改成行内代码,源码模式下用编辑器的“查找替换”功能会精准得多。而在实时渲染模式下,Markdown 标记都被隐藏了,替换时很容易把应该保留的符号也替换掉。我的习惯是:写初稿用实时渲染,只关注内容;定稿前切源码模式,做一次格式清理;最后再切回实时渲染,通读一遍确保没有视觉瑕疵。
3.3 导出 PDF、HTML 与图片:导出流程的实操演示
导出的体验直接决定一个编辑器能不能进入“正式工作流”。mdput 的导出选项集中在“文件”菜单下,支持导出 PDF、HTML、PNG、JPEG,以及复制 HTML 到剪贴板。我经常用的是导出 PDF 和复制 HTML 到剪贴板:写博客时,复制 HTML 可以直接粘到公众号后台或博客系统里,省去不少格式转换的功夫。
导出 PDF 时有几个坑需要注意。第一,字体:默认中文字体在 Windows 下可能是宋体,视觉上不够现代,你可以提前在主题 CSS 里把正文字体改成“思源黑体”或“微软雅黑”,这样导出的 PDF 才好看。第二,代码块在跨页时可能被截断,如果你文档里代码块很多,导出前最好预览一下页码分布,必要时手动调整内容位置。第三,页面边距:mdput 默认的边距偏大,像我这种注重排版的人,一般会在导出设置里把上下边距缩到 2 厘米以内,页面能多放不少内容。
3.4 图片处理:本地相对路径、复制粘贴与图床
Markdown 写作里最让人头疼的环节之一就是图片。mdput 对图片的处理思路和 Typora 类似:可以直接把剪贴板里的截图粘贴到文档中,它会自动保存成图片文件,并在文档中插入对应路径。默认情况下图片会保存到当前文档目录下的assets文件夹,我建议在设置里把图片保存规则改为“相对路径”,这样整个文件夹移动到别处也能正常显示图片,推送到 Git 仓库也不会出现跨平台路径问题。
如果你博客发布用的是在线图床,mdput 也支持自定义图床接口。在设置面板里填入图床的上传地址、请求头、表单字段,粘贴图片时会自动上传到图床,并把返回的 URL 插入文档。这个功能对频繁发布线上文章的人来说非常省心,但配置过程需要一点点接口知识。第一次配置时建议用 Postman 等工具先把图床接口调通,再去编辑器里填入参数,否则排查问题会有点混乱。
4. 性能实测与进阶用法:不止于“能用”
4.1 启动速度、内存占用与长文档表现
我用一套简单的指标做了实测:冷启动时间、空文档内存占用、10000 行文档的输入延迟、长文档滚动帧率。结果还是比较让人满意的:冷启动在我的 Windows 台式机上约 0.6 秒,基本就是双击图标即出窗口;空文档状态下内存占用约 120MB,虽然不算极致轻量,但在现代电脑上完全无感;打开一个包含 10000 行、大量代码块和表格的文档,输入延迟和滚动流畅度依然在线,没有出现过“打字打完一个字要等半秒”的情况。
我个人的体会是,mdput 的性能表现属于“不给你拖后腿”的级别。它没有做过分的性能竞赛,但它的底层渲染做得很克制,不会因为花哨的特效消耗额外资源。对于写作场景,这就足够了。如果你经常写 5000 字以上的长文,或者一个 Markdown 文件里塞了上百张截图,我实测下来它的表现也撑得住,不会比 Typora 差。
4.2 自定义主题与 CSS:把编辑器调成自己喜欢的样子
“轻量”并不意味着不能自定义。mdput 的主题机制其实很开放:设置面板里自带的主题只是一部分,你完全可以把主题 CSS 文件导出,然后在里面修改正文颜色、标题字体、代码块背景、链接样式等任意样式。我把我博客的 CSS 变量名同步到了编辑器的主题里,写博客时看到的效果几乎和发布后的网页一致,这种“所见即最终效果”的体验非常爽。
修改 CSS 时有一点经验要分享:不要直接改内置主题的文件,很多编辑器在更新时会覆盖内置文件;正确做法是复制一份,换个名字另存,然后在设置里重新加载这个自定义主题。你可以在 CSS 里用--mdput-accent-color这类变量调整主题色,也可以直接针对.markdown-body h2这类类名写样式,几乎和写网页 CSS 没有区别。
4.3 文件组织与多文档管理:适合项目型写作
mdput 支持文件夹打开,左侧文件树会递归显示目录下的所有 Markdown 文件。这对于技术文档项目、笔记目录、博客草稿目录来说很重要。打开一个文件夹后,你可以一边修改 A 文件,一边查阅 B 文件的内容,文件树支持文件搜索、新建文件、新建文件夹、重命名、删除等基本操作。
更贴心的是,mdput 会为每个打开的文件保留独立的编辑历史,即使你没手动保存过,关闭编辑器后再打开也能恢复会话。这个功能让我放心地把它当成临时灵感收集器:想到什么直接开个窗口写两句,不用管保存,下次打开还在。当然,关键内容还是建议配合 Git 做版本管理,我一般是对整个文档目录做 Git 仓库,写完一段就提交一次,这样任何时候写崩了都能回到上一版。
4.4 快捷键速查:高频操作的一览表
我把日常使用频率最高的快捷键整理成了一份表,建议你贴在手边,用熟了以后写东西会流畅很多:
| 功能 | Windows / Linux | macOS |
|---|---|---|
| 切换实时渲染 / 源码模式 | Ctrl + / | Cmd + / |
| 插入代码块 | Ctrl + Shift + K | Cmd + Shift + K |
| 插入粗体 | Ctrl + B | Cmd + B |
| 插入斜体 | Ctrl + I | Cmd + I |
| 插入超链接 | Ctrl + K | Cmd + K |
| 插入图片 | Ctrl + Shift + I | Cmd + Shift + I |
| 查找替换 | Ctrl + H | Cmd + Alt + F |
| 隐藏文件树 | Ctrl + B | Cmd + B |
| 专注模式 | Ctrl + Shift + F | Cmd + Shift + F |
这些快捷键和 Typora 高度接近,从 Typora 迁移过来的用户在快捷键上几乎不需要重新学习。
5. 常见问题与排查技巧:这些坑我都替你踩过
5.1 中文输入法丢字、光标错位怎么办
这类问题在所见即所得类 Markdown 编辑器里并不少见,尤其是 Windows 系统搭配搜狗输入法或者某些第三方输入法时更容易出现。遇到这种情况,我的排查顺序是:先把编辑器升级到最新版,再看设置面板里是否有“输入法兼容模式”之类的开关,最后把输入法的“中文标点自动转换”关掉试试。如果问题依旧,切换到源码模式输入,再切回实时渲染模式,大多数时候能临时绕过。不少用户反馈更新到新版本后此类问题明显减少,所以版本维护这块 mdput 做得还算勤快。
5.2 图片粘贴后显示不出来
如果你粘贴图片后只看到图片路径,而不是预览图,一般有三个原因:一是路径上有中文或特殊字符,某些主题渲染对中文路径支持不完善;二是在设置里选了“自定义图床”,但图床没有配置好;三是当前文档还没保存,编辑器不知道图片相对路径的基准位置。解决办法很简单:先把文档保存到目标目录,再粘贴图片,这样编辑器才能正确计算相对路径。如果图片已经插进去了,可以把文档关闭重新打开,让它重新扫描路径。
5.3 导出的 PDF 出现乱码、字体发虚
这是跨平台导出最常见的坑。Windows 下导出的 PDF 里如果中文字体发虚,大概率是因为当前主题定义的字体名在导出引擎里没有对应字体。解决方案是:在主题 CSS 中给正文指定一个系统中真实存在的字体名称,比如"Microsoft YaHei", "PingFang SC", sans-serif,然后重新导出。macOS 上则建议优先使用"PingFang SC"。如果你导出的 HTML 里中文正常、只有 PDF 有问题,那几乎可以确定是字体映射问题,去 CSS 里把字体栈写完整基本就能解决。
5.4 高 CPU 占用、风扇狂转
遇到编辑器高 CPU 占用,我一般会先看是不是正在渲染超大文档。如果文档本身就几千行,又包含大量 Mermaid 图表和图片,渲染占用自然会高。排除了大型文档后,再看是不是主题里有复杂动画或阴影效果,部分 CSS 效果在滚动时会持续消耗 CPU,关掉即可。还有一个排查方向是“实时渲染模式下的外部图片加载”,如果文档里引用了大量远程图片,网络慢时也会拖累渲染。我的建议是写作时图片尽量用本地相对路径,发布前再统一替换成图床链接。
5.5 常用问题排查速查表
| 问题现象 | 直接原因 | 快速解决方案 |
|---|---|---|
| 中文输入法丢字 | 编辑器与输入法兼容问题 | 升级到新版,切换源码模式绕过 |
| 图片只显示路径 | 文档未保存/图床未配置/中文路径 | 先保存文档再粘贴图片,检查图床配置 |
| 导出 PDF 中文发虚 | 主题字体未映射到系统字体 | 修改 CSS 字体栈,指定系统中文字体 |
| 编辑器高 CPU | 大文档渲染或主题动画 | 关闭复杂主题,减少远程图片 |
| 表格渲染错位 | 表格列数过多或单元格内容超长 | 适当拆分表格,避免超长文本堆积 |
| Mermaid 图渲染失败 | 语法版本不兼容 | 检查 Mermaid 官方文档,改用基础语法 |
这张表基本覆盖了我遇到过的 90% 的日常问题。如果你碰到的情况不在里面,我的建议是先去官方仓库搜 issue,很多问题前人已经提过,解决方案通常比你想象的要简单。
写在最后的几个建议
我在实际使用 mdput 的这段时间里,最明显的感受是:它把 Markdown 编辑器最核心的“输入即输出”体验做扎实了。没有多余的通知、没有复杂的设置、没有必须登录的账号体系,打开就是一张白纸让你写字。如果你之前被 Typora 的收费劝退,或者只是单纯想找一个不占内存、启动快的备选编辑器,mdput 值得你花 5 分钟装上试一下。根据我个人经验,从 Typora 迁移过来的成本几乎为零,快捷键和界面布局都高度相似,唯一需要适应的就是主题细节需要自己再调调。如果你主要写技术博客、产品文档、课堂笔记,mdput 完全能扛起来。最后再分享一个小技巧:把它和 Git、图床配置好之后,这套组合完全可以支撑一条从本地写作到线上发布的完整工作流,免费的,跨平台的,还挺稳。