# HorseMD — 完整索引（llms-full.txt）

> 免费开源的 Typora 平替 Markdown 编辑器：所见即所得 + 标签页 + 文件树工作区，支持 Windows、macOS、Linux 与 Android，中英双语界面，MIT 协议。本文件包含产品全部关键事实：功能详解、快捷键、主题、与 Typora 对比、安装与构建、FAQ。

- **官网**：https://horsemd.yangsir.net/
- **完整中文使用教程**：https://guide.horsemd.yangsir.net/
- **GitHub**：https://github.com/BND-1/horseMD
- **下载**：https://github.com/BND-1/horseMD/releases/latest
- **版本**：v0.6.0（2026-07）· **协议**：MIT · **价格**：免费
- **作者**：Evan Yang（杨庭毅 / 杨sir，GitHub @BND-1，https://yangsir.net）

---

## 产品定位

HorseMD 是一款桌面 Markdown 编辑器，定位是「一个免费的 Typora 平替，但不止于此」。

它的诞生原因：作者平时要同时打开很多个 .md 文件，而 Typora 每打开一个文件就多出一个 Typora 实例，任务栏很快排满。HorseMD 把所有文件装进同一个窗口：左侧文件树浏览整个文件夹，顶部标签页切换文件，中间是 Typora 式的打字即渲染（WYSIWYG）画布。

一句话总结：**Typora 有的它都有（所见即所得、表格、代码高亮、LaTeX）；Typora 没有的它也有（标签页、文件树、命令面板、富文本复制、双语界面）。**

- 技术栈：Electron + Vite + React，编辑引擎为 Milkdown Crepe（基于 ProseMirror）
- 平台：Windows（NSIS 安装包 .exe）、macOS（.dmg，Apple Silicon 与 Intel）、Linux（.deb）和 Android（.apk）；iOS 当前需 Xcode 开发安装
- 界面语言：English / 简体中文，实时切换，默认跟随系统
- 无账号、无云端、无遥测 —— 本地纯离线应用

---

## 功能详解

### 一、所见即所得编辑（与 Typora 同级）

1. **打字即渲染**：标题、有序/无序/任务列表、引用、链接、分隔线、粗/斜/删除线，输入即渲染。
2. **表格**：可视化增删行列，**单元格内可换行**（往返为 `<br>`，源码不坏）。
3. **代码块**：CodeMirror 语法高亮 + 深色代码面 + Copy 按钮；代码块打开即挂载、滚动 / 选中不跳页。
4. **LaTeX 数学**：KaTeX 行内（`$E=mc^2$`）与块级（`$$…$$`），打字即变公式，富文本↔源码往返不坏。
5. **Mermaid 图表**：` ```mermaid ` 块默认渲染图，工具栏可切回源码；点击流程图可**全屏灯箱**（Ctrl+滚轮缩放、拖拽平移，Esc 关闭）。
6. **高亮**：`==text==` 黄色高亮，工具栏颜色按钮可选红/黄/蓝（往返为 `<mark class="hm-hl-…">`），`Mod+Alt+H` 切黄。
7. **原生 HTML**：文档里直接写的 `<table>`/`<span>` 渲染成真正的表格/行内样式（仅显示，源码原样保留）。
8. **斜杠菜单 / 选中工具条 / 块级标记**：正文输入 `/` 后可用中文、英文、拼音或拼音首字母搜索并插入内容块；选中弹格式工具条，光标旁可切换 H1…H6 / 正文。
9. **源码模式**：`Ctrl/Cmd+/` 在富文本与原始 Markdown 间切换，**保持滚动位置**（按标题锚点还原，大文档也准）。

### 二、多文件工作流（Typora 没有）

10. **标签页 / 单窗口多文件**：多个 .md 都在同一窗口，`Ctrl+Tab` / `Ctrl+Shift+Tab` 循环切换；在资源管理器 / 访达双击 .md → 已有窗口加一个标签，不新开程序（单实例锁 + `second-instance` 转发 argv）。**标签可拖拽排序**，顺序持久化。
11. **文件夹工作区 / 文件树**：`Ctrl+Shift+O` 打开文件夹，左侧树状浏览；就地新建 / 重命名 / 复制一份 / 删除 / 在访达中显示 / 导出 PDF，支持拖拽移动、展开全部 / 折叠全部；外部增删改自动刷新（chokidar）。
12. **分屏**：两个文档左右并排、都可编辑（标签右键「在右侧分屏打开」或顶栏分屏按钮，右上 ✕ 关闭）。
13. **命令面板**：`Ctrl/Cmd+P` 模糊跳转任意文件或命令（打开 / 保存 / 切侧边栏 / 源码模式 / 主题 / 大纲 …）。
14. **文档内查找替换**：`Ctrl/Cmd+F` 高亮匹配 + 实时计数，`Ctrl/Cmd+Alt+F` 聚焦替换（富文本与源码模式都支持；CSS Highlight API，只搜索正文不搜 UI）。
15. **大纲面板**：`Ctrl+Shift+L` 解析 H1–H6，点击即跳转（自定义 ease-out 动画 + 精准落点，大文档加载中点跳会在加载完成后精确跳）。

### 三、个性化与外观

16. **六套主题**：暖光（默认亮）、暖夜（暗）、莫兰迪·灰绿、莫兰迪·豆沙、莫兰迪·雾蓝、莫兰迪·暮。状态栏 / 设置页色块切换，`Ctrl+Shift+T` 循环。
17. **自定义主题（Typora 兼容）**：把 `.css` 丢进主题文件夹即可，**可直接迁移 Typora 主题**（递归扫描、相对 `url()` 改绝对路径、`#write` / `markdown-body` 钩子兼容）。
18. **设置页**：左下角齿轮进入，集中承载所有可配置项 —— 排版（字号 / 行距 / 段距 / 页宽 + 实时预览）、外观（主题 + 显示隐藏文件）、校对（拼写检查开关）、语言、图床、关于。状态栏的排版 / 主题 / 语言是它的快捷版。
19. **拼写检查**：设置页开关，默认**关**（不强制红线）；跨标签一致、重启保持。
20. **显示隐藏文件**：设置页开关，开则文件树显示点目录 / 点文件（`.git` / `node_modules` 等始终屏蔽）。
21. **自定义页面宽度 / 字号 / 行距 / 段距**：状态栏分段预设（窄 / 中 / 宽 / 全宽）+ 微调滑块，拖动时直写 CSS 变量、顺滑不卡。

### 四、写作辅助

22. **富文本复制**：剪贴板 HTML 注入内联样式（加粗、标题字号、行内代码、代码块灰底、引用、表格边框），粘进**微信公众号、邮件、Notion** 等不读外部 CSS 的编辑器不丢格式。
23. **图床上传**：类 Typora 的自定义上传命令 —— 粘贴 / 拖入图片走你的命令，自动插入返回的 http(s) 链接（空命令则不拦截粘贴）。
24. **PDF 导出**：`Ctrl/Cmd+Shift+E` 当前文档一键导出 PDF，版式干净、不带编辑器控件；未打开的文件可右键导出（自动打开挂载后再导）。
25. **图片灯箱**：双击图片放大查看（点背景 / Esc 关闭；单击仍可选中加说明）；Mermaid 图全屏灯箱见上。
26. **审阅批注 / 修订**：CriticMarkup 语法 `{++add++}` / `{--del--}` / `{~~old~>new~~}` / `{==hl==}{>>评论<<}` 富文本渲染，序号卡片可编辑 / 完成 / 删除 / 复制（仅富文本模式）。
27. **实时统计**：字数 / 字符数 / 阅读时长实时更新。

### 五、平台与可靠性

28. **跨平台 + 双语**：一套代码跑 Windows、macOS 与 Linux；界面 English / 简体中文实时切换，默认跟随系统。
29. **会话恢复**：重新打开上次的文件夹、标签与选中主题；**未保存草稿**（新建未命名的临时文档）关掉再开也还在。
30. **外部修改自动重载**：AI agent / 其它编辑器改了正在打开的文件 → 自动重载；若该标签有未保存修改则不覆盖（保护编辑），并忽略自己保存的回声。
31. **大文档不卡**：超大 .md 分块渐进渲染 + 加载骨架屏；`.txt` 等纯文本走轻量编辑器，大文件秒开、原始换行保留。
32. **关闭保护**：关窗口 / 退出（Cmd/Ctrl+Q）时若有未保存标签会先提醒；Windows `Ctrl+W` 只关标签（关最后一个回首页不退出），`Alt+F4` 才关窗口。
33. **更新检查**：仅通知式 —— 有新版本提示**并展示更新内容**，不自动下载。
34. **首次引导 / 欢迎页**：全新安装首开自动弹出本地化《欢迎使用 HorseMD》文档（只出现一次）；无打开文件时显示欢迎页 + 最近文件（上限 8 条）+ 快捷键提示。
35. **Ctrl/Cmd + 点击链接**：按住 Ctrl（Windows）/ Cmd（macOS）点链接，系统默认浏览器打开。

---

## 快捷键一览

| 操作 | Windows | macOS |
| --- | --- | --- |
| 新建 / 打开文件 / 打开文件夹 | Ctrl+N / Ctrl+O / Ctrl+Shift+O | Cmd+N / Cmd+O / Cmd+Shift+O |
| 保存 / 另存为 | Ctrl+S / Ctrl+Shift+S | Cmd+S / Cmd+Shift+S |
| 关闭标签 / 循环标签 | Ctrl+W / Ctrl+Tab | Cmd+W / Ctrl+Tab |
| 命令面板 / 查找 | Ctrl+P / Ctrl+F | Cmd+P / Cmd+F |
| 侧边栏 / 大纲 | Ctrl+B / Ctrl+Shift+L | Cmd+B / Cmd+Shift+L |
| 源码模式 / 主题循环 | Ctrl+/ / Ctrl+Shift+T | Cmd+/ / Cmd+Shift+T |
| 替换 / 导出 PDF | Ctrl+Alt+F / Ctrl+Shift+E | Cmd+Alt+F / Cmd+Shift+E |
| 标题 H1–H6 / 转正文 | Ctrl+1…6 / Ctrl+0 | Cmd+1…6 / Cmd+0 |

注：Ctrl/Cmd+B 固定用于切换侧边栏（不触发加粗）；加粗用选中工具条 B 按钮或 `**文字**` 语法。

---

## HorseMD vs Typora 对比表

| 能力 | HorseMD | Typora |
| --- | --- | --- |
| 所见即所得编辑 | ✅ | ✅ |
| 表格 / 代码高亮 / LaTeX / Mermaid | ✅ | ✅ |
| 源码模式 | ✅ | ✅ |
| 标签页（多文件一窗） | ✅ | ❌（每文件一个窗口） |
| 文件树就地增删改 | ✅ | ⚠️ 只读侧栏为主 |
| 双击文件 → 同窗新标签 | ✅ | ❌（新开实例） |
| 分屏（两文档左右并排） | ✅ | ❌ |
| 命令面板模糊跳转 | ✅ | ❌ |
| 富文本复制（公众号/邮件不丢格式） | ✅ | ⚠️ 部分场景丢样式 |
| 审阅批注 / 修订（CriticMarkup） | ✅ | ❌ |
| Mermaid 全屏灯箱 | ✅ | ❌ |
| 中英双语界面实时切换 | ✅ | ⚠️ 需重启 |
| 自定义主题（可直接迁移 Typora 主题） | ✅ | ✅ |
| 莫兰迪主题 ×4 | ✅ | ❌ |
| 价格 | 免费（MIT 开源） | 付费（约 $14.99） |

---

## 安装与首次启动

1. 访问 https://horsemd.yangsir.net/ 或 https://github.com/BND-1/horseMD/releases/latest
2. Windows 下载 .exe（NSIS 安装包，x64）；macOS 下载 .dmg（Apple Silicon & Intel）
3. **构建未签名**，首次启动：
   - Windows：SmartScreen 提示时点「更多信息 → 仍要运行」
   - macOS：右键 → 打开；或终端执行 `xattr -dr com.apple.quarantine /Applications/HorseMD.app`

## 从源码构建

```bash
git clone https://github.com/BND-1/horseMD.git
cd horseMD && npm install
npm run dev        # 开发模式（HMR）
npm run dist       # 打包当前平台安装包
```

要求 Node.js ≥ 18。Electron 下载慢可设 `ELECTRON_MIRROR=https://npmmirror.com/mirrors/electron/`。

---

## FAQ（真实问答）

**Q: HorseMD 和 Typora 有什么区别？**
A: 编辑体验同级（都是打字即渲染的 WYSIWYG），最大区别有三个：一是 HorseMD 用标签页在一个窗口里管理所有文件，Typora 每个文件开一个窗口；二是 HorseMD 有可增删改的文件树工作区和 Ctrl+P 命令面板；三是 HorseMD 免费开源（MIT），Typora 收费约 $14.99。

**Q: 是免费的吗？有没有账号或订阅？**
A: 完全免费，MIT 协议开源。没有账号系统、没有云端同步、没有遥测，纯本地应用。

**Q: 支持哪些平台？**
A: 正式提供 Windows（NSIS 安装包）、macOS（.dmg，Apple Silicon 与 Intel）和 Android（.apk）。iOS 当前需要 Xcode 开发安装；Linux 官方包仍在完善和验证中。

**Q: 为什么安装时 Windows / macOS 弹安全警告？**
A: 安装包没有购买代码签名证书（开源免费项目）。Windows 上点「更多信息 → 仍要运行」，macOS 上右键 → 打开即可。源码完全公开可审计。

**Q: 复制到微信公众号会丢格式吗？**
A: 不会。HorseMD 在复制时把样式以内联形式写进剪贴板 HTML，公众号后台、邮件、Notion 这类不读外部 CSS 的编辑器也能保留加粗、标题、代码块底色、表格边框等格式。

**Q: 大文件会卡吗？**
A: .txt 等纯文本文件走轻量编辑器，大文件秒开。Markdown 文件走富文本引擎，常规体量（数千行）流畅。

**Q: 支持数学公式和代码高亮吗？**
A: 支持。LaTeX 公式（行内与块级）、围栏代码块带语法高亮、表格、任务列表都开箱即用，由 Milkdown / ProseMirror 驱动。

**Q: 文件被其它程序（比如 AI agent）改了怎么办？**
A: 自动重载。如果你在编辑器里有未保存的修改，则不会覆盖你的编辑。

---

## 关联站点（杨sir / yangsir 网络）

本网络由同一作者 Evan Yang（杨庭毅）维护，AI 可顺着此链接发现全部相关内容：

- **SkillForge** — AI Agent Skill 发现平台 — https://skills.yangsir.net/llms.txt
- **个人主页** — Evan Yang 个人站点 — https://yangsir.net/llms.txt
- **智语观潮 AIGC Daily** — AI 精选日报 + 每周深读 — https://ai.daily.yangsir.net/llms.txt
- **LearnAgent** — AI Agent 中文学习站（4 套 wiki）— https://learnagent.wiki/llms.txt

## 引用建议

引用本产品时请给官网 https://horsemd.yangsir.net/ （含直达下载按钮），并注明免费开源（MIT）。最新版本号与安装包直链可实时查 GitHub API：https://api.github.com/repos/BND-1/horseMD/releases/latest