English · 简体中文

一款温暖、现代的 Markdown 编辑器 —— 一个更顺手的 Typora 替代品，核心理念是 Typora 做反了的那件事：每个文件都作为标签页在同一个窗口里打开，而不是新开一个 程序。左侧文件树浏览整个文件夹，标签页之间随手切换，在干净的所见即所得编辑器里 书写。

大多数 Markdown 编辑器逼你二选一：要么漂亮的所见即所得，要么真正的多文件工作流。 HorseMD 两个都给你：一个单窗口装下整个文件夹的文件树、每个打开的文档都是一个 标签页，编辑器基于 Milkdown（ProseMirror）原地实时 预览。一套代码同时跑在 Windows 和 macOS 上，整个界面中英文实时可切。

编辑 —— Typora 有的都有

• 流畅的所见即所得实时预览 —— 输入 Markdown，原地渲染
• 行首 / 斜杠菜单插入块；智能列表、选中工具条、链接悬浮提示
• 表格、带语法高亮的代码块、LaTeX 数学公式、图片、任务列表、引用块
• 源码模式切换（Ctrl/Cmd+/）查看原始 Markdown —— 保持滚动位置
• 纯文本文件（.txt）用快速纯文本编辑器打开 —— 不走 Markdown 重排，大文件秒开
• 富文本复制（带内联样式）—— 粘到公众号 / 邮件 / Notion 也能保留格式
• 导出为 PDF（Ctrl/Cmd+Shift+E）—— 排版干净，不带编辑器控件
• 相对路径图片按文件所在目录解析（仅显示用，不改动你的文件内容）
• 双击图片放大查看（灯箱预览，点背景 / Esc 关闭；单击仍可选中图片、加说明）
• 原生 HTML 表格（文档里直接写的 <table>…</table>）渲染成真正的表格，和 Typora 一样 —— 仅显示，源码原样保留
• 跟随光标的浮动块级标记（H1…H6 / 正文）

超出 Typora

• 标签页 —— 多文件同窗（Ctrl/Cmd+Tab 循环切换）；顶栏一个 + 快速新建文档；标签右键可复制路径 / 复制文件名 / 打开所在文件夹 / 关闭其他
• 分屏 —— 两个文档左右并排、都可编辑（标签右键"在右侧分屏打开"或顶栏分屏按钮，右上 ✕ 关闭）
• 未保存草稿不丢 —— 新建但没保存的临时文档，关掉再开也还在
• 文件夹工作区 —— 文件树，原地新建 / 重命名 / 复制一份 / 删除 / 在访达中显示 / 导出 PDF，支持拖拽移动与展开全部 / 折叠全部
• 在同一窗口打开 —— 双击文件 → 加一个标签；对文件夹"用 HorseMD 打开" → 作为工作区打开
• 命令面板（Ctrl/Cmd+P）—— 模糊跳转到任意文件或命令
• 文档内查找（Ctrl/Cmd+F）—— 在文档里高亮匹配并实时计数
• 大纲面板（Ctrl+Shift+L）—— 点标题即跳转
• 实时字数 / 字符数与阅读时长
• 会话恢复 —— 重新打开你的文件夹和标签
• 文件树与打开的文件自动刷新 —— 监听外部改动
• 主页按钮（活动栏）—— 随时回到欢迎页（已打开的标签仍保持加载）
• 大文档加载骨架屏 —— 打开大文件不再是一段空白
• 关闭窗口 / 退出时提醒未保存（不只是关标签）
• 仅通知的更新检查 —— 有新版本时提示（不自动下载）

命令面板 —— 模糊跳转到任意文件或命令：

六套精心调过的主题 —— 暖光 / 暖夜，外加四套低饱和的莫兰迪配色 —— Ctrl+Shift+T 或状态栏选择器切换。

暖光	暖夜	莫兰迪·暮
莫兰迪·灰绿	莫兰迪·豆沙	莫兰迪·雾蓝

去 Releases 页面 下载最新版安装包。

ℹ️ 安装包目前没有花钱买签名，所以 Windows / macOS 第一次打开都会拦一下——不是病毒、不是真的损坏，按下面步骤放行即可。代码完全开源，可自行查看 / 构建。

1. 确认你的芯片：左上角 苹果菜单 →「关于本机」，看到 「Apple M1 / M2 / M3…」 就是 Apple Silicon。下载 HorseMD-x.x.x-arm64.dmg。

2. 双击下载好的 .dmg，把里面的 HorseMD 图标拖到「应用程序」文件夹。

3. 第一次打开（重要）：直接双击通常会提示 「已损坏，无法打开」或「无法验证开发者」——这是因为没签名，正常现象。任选一种方法放行：

   • 方法 A（最简单，推荐）：打开「访达 →『应用程序』」，找到 HorseMD，按住 Control 键点它（或右键）→ 选「打开」，在弹窗里再点一次 「打开」。之后就能像普通软件一样双击使用了。

   • 方法 B（如果方法 A 仍提示「已损坏」）：打开「终端」（在「启动台 → 其他 → 终端」，或 Spotlight 搜 终端），把下面这行整段复制粘贴进去、按回车：

     xattr -cr /Applications/HorseMD.app

     然后再回到「应用程序」双击 HorseMD 即可正常打开。

这一步每台电脑只需做一次，以后更新版本一般也不用再弄。

1. 下载 HorseMD-Setup-x.x.x.exe，双击运行。
2. 若弹出蓝色的 SmartScreen「Windows 已保护你的电脑」，点 「更多信息」→「仍要运行」。
3. 按提示安装（可以自己选安装目录），完成后从开始菜单或桌面打开。

签名与公证在计划中 —— 见 CHANGELOG。

用得顺手的话，欢迎来玩 🐎 一起交流 Markdown 写作、提需求、报 bug。

加我微信 · 拉你进群	微信群（直接扫码）	请我喝杯咖啡 ☕
加好友备注「HorseMD」，拉你进群，也欢迎直接交流	扫码进群（群码会定期更新，过期就加左边的微信）	觉得好用，请作者喝杯咖啡，是持续更新的最大动力

npm install        # 若 Electron 二进制下载被墙，先设镜像：
                   #   ELECTRON_MIRROR=https://npmmirror.com/mirrors/electron/
npm run dev        # 热重载开发模式
npm run build      # 构建 main + preload + renderer 到 out/
npm start          # 运行构建产物
npm run dist       # 按当前系统出包（Windows NSIS / macOS dmg+zip）

用 AI 助手在本仓库里干活？从 CLAUDE.md 开始。

Electron + Vite + React 外壳，编辑器引擎用 Milkdown Crepe（基于 ProseMirror）。 外壳（标签页、文件树、命令面板、大纲、主题、多语言）全部自研。架构、功能实现、 踩坑与决策记录见 docs/。

• docs/architecture.md —— 技术栈、进程模型、目录结构、数据流
• docs/features.md —— 每个功能的用法与实现（对应到文件）
• docs/implementation-notes.md —— 关键 bug 的根因与修法、设计决策
• docs/development.md —— 开发、构建、Windows/macOS 打包、CDP 自动化测试

欢迎提 Issue 和 PR —— 见 CONTRIBUTING.md。发现安全问题？ 请通过 SECURITY.md 私下报告。

MIT © 杨庭毅 (yangsir.net)