Typora免费平替：mdput开源Markdown编辑器深度体验

说实话，这几年我被身边朋友问得最多的一句话就是：Typora有没有免费平替？不是不愿意付费，而是很多人只是偶尔写点Markdown，为一个编辑器买断授权总觉得不划算。再加上网上越来越多人在搜“typora免费版”“typora序列号”，我就知道，大家真正想要的是一款免费、轻量、不折腾的Markdown编辑器。mdput就是我在这个需求下挖到的一个新选择。

先说结论：mdput是一款免费开源、跨平台的Markdown编辑器，主打轻量、实时渲染和开箱即用。和Typora的体验非常接近，但不用授权、不弹窗、不占资源。我用它写了几天技术笔记、导出了几份PDF，整体感受是：日常写作完全够用，部分场景甚至比Typora更清爽。

这篇文章不是云评测，我会把下载安装、第一次启动、日常写作、导出PDF、常见坑全部过一遍，尤其是中文输入法、公式排版、图片路径这类Typora老用户迁移时会遇到的问题。如果你手头有大量.md文件想换编辑器，这篇文章可以直接照着操作。

1. 为什么说mdput是Typora的免费平替

1.1 Typora很好，但“免费”这件事变了

Typora在1.0之前是免费公测的，很多人习惯了随手打开一个窗口就写。后来转成付费买断，15天试用期一到，编辑器会频繁弹窗提醒，网上就出现了大量“typora激活”“typora序列号免费”这类搜索。其实从产品角度看，Typora收费不算离谱，毕竟做跨平台实时渲染这种体验，开发和维护成本都摆在那。但从用户角度看，一个工具从免费变收费，换了谁心里都会咯噔一下，尤其对低频用户来说，为一个写作工具花几百块钱确实不太值。

我见过太多同事因为弹窗烦，干脆退回纯文本编辑器或者在线文档。但Markdown的精髓就在于本地文件可控、语法轻、以后还能迁移，如果因为编辑器收费就放弃，挺可惜的。这时候，开源免费的替代品就成了最优解。

1.2 mdput主打什么：轻量、免费、可控

mdput的核心卖点可以概括成四个字：轻量免费。它没有走那种大而全家桶路线，而是坚持做一件事：开一个窗口，写Markdown，所见即所得。和Typora一样，它也是把编辑区变成渲染后的样子，不是左边源码右边预览那种割裂感。

安装包体积很小，我这边安装完占用的磁盘空间比Typora小不少，后台内存占用也在可接受范围内。开发者把这套东西做成了一个独立项目，没有账户体系，不需要注册登录，首次打开就能直接用，不存在什么试用期概念。这对于只想安静写作的人来说，体验非常干净。

1.3 mdput和Typora的差异对照

从表格能看出来，mdput想做的不是把Typora所有功能复制一遍，而是把最高频的写作需求做到顺手。如果你只是写技术文档、笔记、博客草稿，它完全够用。如果你重度依赖某些Typora插件，那迁移前要先确认新工具是否有对应方案。

2. 下载安装与第一次启动：不折腾，也不踩坑

2.1 安装包从哪下，怎么确认没有捆绑

mdput是开源项目，所以最稳的渠道就是GitHub的官方仓库，到Releases页面下载对应系统的安装包。按平台选文件：Windows下一般是.exe或.msi，macOS下是.dmg，Linux下可能是.deb、.rpm或者AppImage。下载完先核对一下文件名和官方页面是否一致，别从第三方下载站随便拿一个，那些网站经常给安装包塞一堆推广软件。

安装过程没什么特别，一路下一步就行。macOS上如果提示“已损坏”或者无法打开，通常是Gatekeeper的问题，去“系统设置 - 隐私与安全性”里允许运行即可，这不是软件本身的问题。Windows上如果杀毒软件报未知，建议先去官方核对文件校验值，因为新开源软件没有数字签名很常见，但只要是从官方渠道拿的一般没事。

2.2 第一次启动后的推荐设置

第一次启动，界面和Typora一样简洁：上面是菜单栏，中间是编辑区，下面一行状态栏。我推荐先改几个设置，能少踩很多坑。

• 主题：喜欢深色就选深色，喜欢浅色就选浅色，mdput自带几套默认主题，也可以在设置里加载自定义CSS主题文件。
• 字体：中文用户建议把界面字体设置为“系统默认”或者包含中文的回退字体，比如macOS用PingFang SC，Windows用Microsoft YaHei，避免英文和中文混排时字体风格不统一。
• 自动保存：打开自动保存，编辑文档不怕断电。
• 图片保存路径：建议设置成“当前文档所在目录下的assets或images文件夹”，以后迁移整篇笔记时图片能一起带走。
• Markdown扩展：把GFM相关选项都打开，表格、任务列表、删除线、脚注这些才能正常渲染。

这些设置不是必须，但按我的经验，提前弄好能避免后续导出的乱排版。

2.3 界面布局：三分钟认识所有功能区

mdput的默认窗口分三个主要区域。最左侧是文件树，可以打开一个文件夹作为工作区，方便管理多篇笔记。中间是编辑区，也是平时眼睛盯着最多的区域。右侧通常没有常驻面板，但在源码模式、大纲模式或者预览模式下会出现对应功能。

很多人第一次找不到大纲，其实在视图菜单里打开“大纲”就行，它会根据Markdown的标题层级自动生成目录，鼠标点一下就能跳转，长文档写作时特别实用。状态栏一般显示字数、当前行号、语法模式等，有些版本还能在这里快速切换编辑模式。

3. 日常写作体验：从Markdown语法到中文输入法

3.1 实时渲染和源码模式，怎么用更顺手

mdput最核心的交互是实时渲染，也就是光标所在段落显示成Markdown源码，离开这个段落后自动渲染成最终样式。这种交互是Typora当年圈粉的关键，写起来没有割裂感，同时又能控制格式。

除了实时渲染，它一般还提供源码模式。源码模式下整篇文档显示为原始Markdown文本，适合批量调整格式、查找替换、复制到其他平台。我自己的习惯是：日常写作用实时渲染，做全局修改时切源码模式，两个模式配合，效率非常高。

如果你在编辑长表格，或者包含复杂公式的文档，实时渲染可能会出现光标跳动或者排版错乱，这是很多同类编辑器的通病。遇到这种情况，切到源码模式改完再切回来，基本都能解决。

3.2 GFM语法支持与高频操作

mdput对GitHub Flavored Markdown的支持比较完整，我日常会用到的高频操作基本都覆盖：

• 标题：#到######六个层级，快捷键Ctrl+1到Ctrl+6设置
• 加粗/斜体：**粗体**、*斜体*，快捷键Ctrl+B、Ctrl+I
• 无序/有序列表：-、1.
• 任务列表：- [ ]和- [x]
• 引用块：行首加>，显示为左侧竖线的引用样式
• 表格：竖线加表头，支持对齐
• 代码块：三个反引号加语言名，支持代码高亮
• 行内代码：单个反引号包裹
• 链接：[说明文字](地址)
• 图片：![说明](图片路径)
• 脚注：[^1]加注释
• 删除线：~~删除~~
• 换行：行尾加两个空格再回车，或者用空行分段

这里重点说两个新手经常卡的坑。一个是换行，很多人按回车发现和上一行还是连在一起，是因为Markdown默认换行需要两个空格加回车，或者干脆空一行分段。另一个是引用块，网上搜“markdown一段文字前面加一个竖杠”就是在问这个，在文字前输入>再加空格，就能得到左侧带竖线的引用块。

代码块还有一个隐藏需求：设置默认语言。如果你几乎只写Python或者Shell，可以在设置里指定默认代码块语言，这样每次插入代码块都会自动带上对应语言标识，省得每次手敲。

3.3 中文输入法和光标跟随：我实测的结论

这块我要单独拿出来说，因为中文用户换Markdown编辑器，最担心的就是输入法不兼容。我实测了Windows和macOS两个平台，mdput在中英文混输、候选词选字、光标跟随这些场景下，整体表现是比较稳的，没有出现输入一个字母光标乱跳的情况。

不过有一个细节要注意：不要开着输入法的“中英文标点自动转换”写Markdown语法，尤其是在输入反引号、竖线、冒号这些符号时，一旦被输入法转成全角，表格和行内代码就会失效。我的习惯是写Markdown符号时临时切到英文标点，或者直接在设置里让输入法默认使用半角标点。

另外，如果你用的是比较小众的输入法，建议到手后先写一小段带代码、表格、公式的测试文档，确认输入法候选框和编辑器没有位置冲突，再决定要不要正式迁移。

3.4 图片粘贴与存储路径

写作时贴图是很高频的操作。mdput支持直接截图粘贴到文档，默认会生成一张图片文件，并自动插入相对路径。这里有三种存储方式：绝对路径、相对路径、Base64内嵌。我强烈建议选相对路径，也就是把图片放到当前文件夹下的某个子目录里，这样整个文件夹搬到别处，图片也不会丢。

如果你是从Typora搬过来的老笔记，Typora的图片默认也支持相对路径配置，所以迁移时只要把整个文档目录原样带过去，通常不会出现图片丢失。如果之前用的是绝对路径或者图床，那就得检查一下图片能不能正常加载，必要时批量替换为相对路径。

4. 导出工作流：PDF、HTML和Word

4.1 导出PDF的完整操作与中文避坑

写作完成后，很多人第一件事就是导出PDF。mdput的导出逻辑很简单：文件菜单里选择导出PDF，会按照当前编辑区的渲染结果生成PDF，能做到所见即所得。但我也遇到过几个经典问题，这里集中说下。

第一个坑是中文乱码或中文显示成方块。这通常不是mdput的Bug，而是PDF生成时没有找到合适的中文字体。解决办法是在设置或者导出模板里指定一个系统自带的中文字体，比如Windows用微软雅黑、macOS用苹方。如果你导出的文档要打印或发给别人看，字体选择别太花哨，宋体或黑体类最稳。

第二个坑是代码块换行和分页。代码块通常不会自动换行，一行代码太长就会被截断，但多行代码放在PDF里又可能出现一页切到另一页时被从中间截断。我建议导出前手动检查一遍长代码块，或者把页面边距调大一点，给代码留出空间。

第三个坑是表格在页面边缘被裁掉。和Typora一样，导出PDF时如果表格太宽，需要提前缩小字号或者简化列数。你可以先导出一次看效果，再回头调整。这个流程虽然原始，但对绝大多数人来说够用了。

4.2 HTML导出与博客发布

如果你写的是博客草稿，导出HTML比PDF更实用。mdput支持直接导出单个HTML文件，里面会内联样式和图片，直接上传到任何支持HTML的博客后台，样式基本能保留。

导出的HTML适合放在浏览器里打印、发邮件、或者给不会Markdown的同事看。有朋友问有没有Chrome查看Markdown的插件推荐，那是另一个场景了，如果你只是想快速在浏览器里预览.md文件，在线Markdown预览网站也能应急。但mdput作为桌面工具的优势是可以离线编辑、本地保存，文件始终在你自己手里。

4.3 用Pandoc补上Word导出

mdput自带的导出一般集中在PDF和HTML，如果你要交Word版文档，最省心的方案是装一个Pandoc。Pandoc是一个文档转换工具，能把Markdown转成Word、LaTeX、EPUB等格式，具体命令很简单：

pandoc input.md -o output.docx --resource-path=.

--resource-path=.是为了让Pandoc在当前目录下找到文档引用的图片，执行完后，Word文件里会有基本段落样式、表格和图片。如果以后还想写论文、出幻灯片，Pandoc这套工作流也值得单独学一下。

我们还可以把导出步骤做成一键脚本，比如写一个简单的shell脚本，把当前文件夹下的所有Markdown文件批量转成Word。用到的逻辑不复杂，但很能提升效率。

5. 高频问题与避坑笔记：Typora用户迁移必看

5.1 关于“Typora序列号/激活”的大实话

写到这里，我想专门聊一个很多人都在搜的话题：Typora序列号、Typora免费版激活。每次看到这些搜索词，我都想说，真的别在这上面花时间了。

Typora试用期结束后会弹窗提醒购买，这个弹窗是官方行为，不是什么病毒木马。但网上流传的“激活”手段，要么是旧版本的破解补丁，要么是一堆乱七八糟的注册机，下载下来轻则被广告软件骚扰，重则可能打包恶意脚本。为了一个编辑器冒这个风险，太不值得。

我的建议很简单：如果你真心喜欢Typora，买一个授权，支持正版。如果你不想为写作工具付费，那直接用mdput这类免费开源软件就好。免费的并不代表差，很多开源工具在核心体验上已经非常能打了，尤其是在本地写作这个场景。

5.2 常见问题速查表

这张表不是让你背下来，而是遇到问题的时候知道去哪儿查。用开源软件的好处是问题可以在社区反馈，很多时候作者的响应速度比商业软件还快。

5.3 Markdown新手最容易卡的几个点

如果你刚接触Markdown，这里再补几个基础点。第一，Markdown文件就是纯文本文件，后缀是.md，用任何记事本都能打开，所以你的内容永远不会被某个编辑器锁死。第二，语法符号必须是英文半角，很多新手用中文输入法打出来的#是全角，就无法生效。第三，一个段落里想强制换行，行尾敲两个空格，或者直接插一个空行分段，二者效果不一样，前者只是换行，后者是新的段落。

曾经有朋友问我，为什么他写的列表后面接了一段文字，文字被缩进了。这种情况多半是他列表后面没有空行，Markdown会把后续内容识别成同一个列表块。解决方法是列表结束之后加一个空行，再开始新的段落。

另外，如果另一半习惯用Word，而我们自己在用Markdown，导出Word的场景就会经常出现。这时候别焦虑，Pandoc加上一个简单的命令就能解决，配合模板还能调样式。

6. 换用mdput一周后，我的实际感受

把mdput当成主力编辑器用了一周之后，我最大的感受是：一个写作工具的好坏，不在于功能堆了多少，而在于它会不会打断思路。mdput在这方面的克制做得很好，没有弹窗、没有账户体系、没有一堆用不上的按钮，打开就是一段干净的空白，可以立刻开始打字。

当然，它也不是没有缺点。比如插件生态还在积累期，某些Typora的第三方主题和增强功能在mdput上未必有对应替代；再比如它的社区相对小，遇到冷门问题可能要自己查源码或者翻英文Issue。但对我来说，这些都不是核心场景。

如果你手里的Markdown文件都是本地文档，日常只写技术博客、项目说明、会议记录，我建议你给mdput一个机会。下载、解压、写几百字、导出一次PDF，这几个步骤走完，基本就能判断它适不适合你。

最后分享一个小技巧：换了编辑器之后，记得把默认保存的文件编码设置成UTF-8，尤其是Windows下，不然在别的平台打开有可能出现乱码。很多编辑器默认就是UTF-8，但以防万一，还是手动确认一下。我用mdput写文档时始终开着这个设置，跨平台分享从来没出过乱码。