说实话这几年我被身边朋友问得最多的一句话就是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的差异对照对比项Typoramdput价格买断制有试用期免费开源实时渲染支持支持平台Windows/macOS/LinuxWindows/macOS/Linux账户/联网需要授权验证无需账户离线可用主题/自定义主题丰富支持自定义CSS生态相对小插件/扩展社区插件较多核心功能务实扩展少导出能力PDF/HTML/Word等PDF/HTML为主Word可配合Pandoc安装包体积中等小从表格能看出来mdput想做的不是把Typora所有功能复制一遍而是把最高频的写作需求做到顺手。如果你只是写技术文档、笔记、博客草稿它完全够用。如果你重度依赖某些Typora插件那迁移前要先确认新工具是否有对应方案。2. 下载安装与第一次启动不折腾也不踩坑2.1 安装包从哪下怎么确认没有捆绑mdput是开源项目所以最稳的渠道就是GitHub的官方仓库到Releases页面下载对应系统的安装包。按平台选文件Windows下一般是.exe或.msimacOS下是.dmgLinux下可能是.deb、.rpm或者AppImage。下载完先核对一下文件名和官方页面是否一致别从第三方下载站随便拿一个那些网站经常给安装包塞一堆推广软件。安装过程没什么特别一路下一步就行。macOS上如果提示“已损坏”或者无法打开通常是Gatekeeper的问题去“系统设置 - 隐私与安全性”里允许运行即可这不是软件本身的问题。Windows上如果杀毒软件报未知建议先去官方核对文件校验值因为新开源软件没有数字签名很常见但只要是从官方渠道拿的一般没事。2.2 第一次启动后的推荐设置第一次启动界面和Typora一样简洁上面是菜单栏中间是编辑区下面一行状态栏。我推荐先改几个设置能少踩很多坑。主题喜欢深色就选深色喜欢浅色就选浅色mdput自带几套默认主题也可以在设置里加载自定义CSS主题文件。字体中文用户建议把界面字体设置为“系统默认”或者包含中文的回退字体比如macOS用PingFang SCWindows用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的支持比较完整我日常会用到的高频操作基本都覆盖标题#到######六个层级快捷键Ctrl1到Ctrl6设置加粗/斜体**粗体**、*斜体*快捷键CtrlB、CtrlI无序/有序列表-、1.任务列表- [ ]和- [x]引用块行首加显示为左侧竖线的引用样式表格竖线加表头支持对齐代码块三个反引号加语言名支持代码高亮行内代码单个反引号包裹链接[说明文字](地址)图片脚注[^1]加注释删除线~~删除~~换行行尾加两个空格再回车或者用空行分段这里重点说两个新手经常卡的坑。一个是换行很多人按回车发现和上一行还是连在一起是因为Markdown默认换行需要两个空格加回车或者干脆空一行分段。另一个是引用块网上搜“markdown一段文字前面加一个竖杠”就是在问这个在文字前输入再加空格就能得到左侧带竖线的引用块。代码块还有一个隐藏需求设置默认语言。如果你几乎只写Python或者Shell可以在设置里指定默认代码块语言这样每次插入代码块都会自动带上对应语言标识省得每次手敲。3.3 中文输入法和光标跟随我实测的结论这块我要单独拿出来说因为中文用户换Markdown编辑器最担心的就是输入法不兼容。我实测了Windows和macOS两个平台mdput在中英文混输、候选词选字、光标跟随这些场景下整体表现是比较稳的没有出现输入一个字母光标乱跳的情况。不过有一个细节要注意不要开着输入法的“中英文标点自动转换”写Markdown语法尤其是在输入反引号、竖线、冒号这些符号时一旦被输入法转成全角表格和行内代码就会失效。我的习惯是写Markdown符号时临时切到英文标点或者直接在设置里让输入法默认使用半角标点。另外如果你用的是比较小众的输入法建议到手后先写一小段带代码、表格、公式的测试文档确认输入法候选框和编辑器没有位置冲突再决定要不要正式迁移。3.4 图片粘贴与存储路径写作时贴图是很高频的操作。mdput支持直接截图粘贴到文档默认会生成一张图片文件并自动插入相对路径。这里有三种存储方式绝对路径、相对路径、Base64内嵌。我强烈建议选相对路径也就是把图片放到当前文件夹下的某个子目录里这样整个文件夹搬到别处图片也不会丢。如果你是从Typora搬过来的老笔记Typora的图片默认也支持相对路径配置所以迁移时只要把整个文档目录原样带过去通常不会出现图片丢失。如果之前用的是绝对路径或者图床那就得检查一下图片能不能正常加载必要时批量替换为相对路径。4. 导出工作流PDF、HTML和Word4.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 常见问题速查表问题原因解决办法导出PDF中文乱码缺少中文字体映射在导出设置里指定系统中文字体表格复制到Excel变形普通文本粘贴不带表格结构用HTML导出后再粘贴或另存为CSV格式Markdown换行不生效没有两个空格或空行行尾加两个空格再回车公式靠左而不是居中渲染样式默认居中在自定义CSS里调整公式display样式图片不显示路径是绝对路径或图片被移动改用相对路径并确认图片文件夹一起迁移代码块默认语言不对没设置默认语言在设置中指定默认代码块语言输入法下反引号/竖线变全角输入法自动转换中文标点写Markdown符号时切英文标点打开大文档卡顿渲染节点太多切源码模式编辑或拆分文档编辑器闪退多为旧版本Bug或插件冲突升级到最新版本并记录触发操作反馈给作者这张表不是让你背下来而是遇到问题的时候知道去哪儿查。用开源软件的好处是问题可以在社区反馈很多时候作者的响应速度比商业软件还快。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写文档时始终开着这个设置跨平台分享从来没出过乱码。