MD Reader
English | 简体中文
-lightgrey)
一个轻量、快速、所见即所得的 Markdown 桌面阅读器与编辑器，基于 Tauri 2 + Vue 3 + Rust 构建。
体积小（约 6 MB），启动快，支持多标签页、源码编辑、公式、图表、代码高亮、文件树、全文搜索、PDF/HTML/DOCX/PNG 导出。
📦 下载最新版本
主要特性
多标签页
- 同时打开多个 Markdown 文件，工具栏下方水平标签栏切换
- 点击切换、中键关闭，再次打开已打开的文件会聚焦到对应标签而非重复打开
- 每个标签独立保留内容、未保存草稿、编辑/预览模式、大纲和滚动位置，切换即恢复现场
- 标签页右键菜单：关闭 / 关闭其他标签 / 关闭全部、刷新、复制文件路径、打开文件所在文件夹
- 应用重启后自动恢复上次打开的标签列表与激活项
阅读
- CommonMark + GitHub Flavored Markdown
- YAML Front Matter 解析与预览：顶部
--- 元数据渲染为信息卡片，正文和大纲自动剥离元数据
- 代码语法高亮（highlight.js，30+ 语言）
- 数学公式（KaTeX，按需加载）
- Mermaid 图表 20+ 种（流程图、时序图、甘特图、类图、状态图、思维导图、饼图等，按需加载，SVG 经 DOM 解析清洗，仅剥除脚本与事件属性）
- 任务列表 / 脚注 / Emoji / 标题锚点
- 亮 / 暗主题切换，记忆主题偏好
编辑
- CodeMirror 源码编辑模式，支持 Markdown 高亮、行号、折叠、括号匹配、查找/替换、跳转行
- 预览 / 编辑一键切换（
Ctrl+E），切换时按源码行同步视口位置
- Markdown 格式化快捷键：
Ctrl+B 加粗、Ctrl+I 斜体、Ctrl+U 下划线、Ctrl+L 高亮、Ctrl+Shift+` 行内代码
- 编辑模式下
Ctrl+V 粘贴图片，自动保存到当前文件同目录 images/ 并插入 Markdown 链接
- 手动保存 / 另存为，切换文件、关闭标签、关闭窗口和外部变更时保护未保存修改
导航
- 左侧文件树，递归扫描文件夹
- 大纲（TOC）滚动同步高亮，支持分级展开折叠（▶/▼ 箭头 + 全部展开/折叠按钮，全部折叠显示到二级标题）
- 大纲位置可在设置中切换：左侧（侧栏 tab，工具栏大纲按钮隐藏）/ 右侧（独立面板），默认右侧
- 三栏可拖拽分隔条，独立显隐
- 内部链接
[文本](./other.md#锚点) 跳转
- 图片相对路径自动解析
查找
Ctrl+F 当前文档查找（高亮、上一/下一）Ctrl+Shift+F 跨文件全文搜索（Rust 后端高速）
导出
- PDF（Edge headless，1-3 秒，所见即所得，无 LaTeX；24 套预设模板 + 字体 / 颜色 / 间距密度 / 页面样式可调，设置内实时预览，详见下方「PDF 导出样式」）
- PNG 长图（整篇渲染为一张所见即所得的长图，含公式 / 图表 / 代码高亮 / 表格；默认 2 倍缩放，超长文档自动适配画布上限）
- HTML（自包含单文件，图片/CSS 全部内嵌）
- DOCX（pandoc 路线，需安装 pandoc；可设置 Word 模板
.docx 通过 --reference-doc 控制字体、标题和段落样式）
体验
- 阅读设置：字号、编辑器字号、行高、宽度、字体、大纲位置可调
- 阅读区背景颜色：亮 / 暗主题分别自定义，支持预设色板与一键恢复默认
- 快捷键自定义：设置 -> 查看快捷键，点击键帽录制新组合，支持全局和编辑器快捷键、冲突检测、逐项/全部重置
- 文件变更监听，自动刷新
- 最近文件 + 滚动位置记忆；空状态展示最近文件列表，点击直接打开
- 文件关联：
.md / .markdown / .mdx 双击直接打开；设置页可一键注册当前用户级文件关联（绿色版也可用）
- 单例运行：从资源管理器多次打开会复用窗口
- 拖拽文件到窗口直接打开
- 界面语言切换：简体中文 / English
- 检查更新：设置页可查看当前版本并对比 GitHub Releases 最新版，发现新版本可一键打开下载页
快捷键
| 键 |
动作 |
Ctrl+E |
切换预览 / 编辑模式 |
Ctrl+B |
加粗（编辑模式） |
Ctrl+I |
斜体（编辑模式） |
Ctrl+U |
下划线（编辑模式） |
Ctrl+L |
高亮（编辑模式） |
Ctrl+Shift+` |
行内代码（编辑模式） |
Ctrl+F |
当前文档查找；编辑模式下打开编辑器查找 |
Ctrl+H |
编辑模式下替换 |
Ctrl+G |
编辑模式下跳转行 |
Ctrl+Shift+F |
全文搜索 |
Ctrl+N |
新建 Markdown 文件 |
Ctrl+O |
打开文件 |
Ctrl+W |
关闭当前标签 |
Ctrl+Tab |
下一个标签 |
Ctrl+Shift+Tab |
上一个标签 |
Ctrl+→ |
向右切换标签 |
Ctrl+← |
向左切换标签 |
Ctrl+, |
阅读设置 |
Ctrl+S |
保存当前文件 |
Ctrl+Shift+S |
另存为 |
Ctrl+P |
系统打印 / 另存为 PDF |
Ctrl+= |
放大字体（编辑模式调编辑器字号，预览模式调阅读字号） |
Ctrl+- |
缩小字体（同上） |
Ctrl+0 |
重置字体为默认（编辑器 14px，阅读 16px） |
Ctrl+滚轮 |
放大/缩小字体（同 Ctrl+=/-，两模式分流） |
Esc |
关闭查找 / 设置 / 弹窗 |
以上快捷键均可在「设置 -> 查看快捷键」中自定义（Esc 和滚轮缩放除外）。
界面展示
安装
Windows（正式版）
从 Releases 页面 下载：
| 文件 |
说明 |
MD-Reader-*-windows-x64-setup.msi |
安装版：双击安装，自动注册 .md / .markdown / .mdx 文件关联 |
MD-Reader-*-windows-x64-portable.exe |
绿色版：解压即用，不写注册表 |
MD-Reader-*-windows-x64-portable.zip |
绿色版压缩包：解压后运行，避免浏览器拦截 exe 下载 |
Windows 10 / 11 自带 WebView2 Runtime，无需额外安装。旧版 Windows 10 可能需要从 Microsoft 官网 单独安装 WebView2 Runtime。
macOS / Linux（实验版）
macOS 和 Linux 构建目前为实验性，由 GitHub Actions 在发布 tag 时自动构建并附加到 Releases 页面，未做代码签名：
- macOS：下载
.dmg 或 .app.tar.gz
- Linux：下载
.AppImage / .deb / .rpm
实验版未签名：macOS 首次打开需右键 → 打开，或执行 xattr -dr com.apple.quarantine "MD Reader.app"；Linux AppImage 需先 chmod +x。
使用前需要安装的外部工具
核心阅读和编辑功能完全不需要安装任何东西。可选功能按需安装：
| 功能 |
依赖 |
Win10/11 默认 |
安装方法 |
| 阅读 / 编辑 / 多标签 / 文件树 / 全文搜索 / 公式 / 图表 / HTML / PNG 导出 |
无 |
— |
无需安装 |
| PDF 导出（所见即所得） |
Microsoft Edge（Chromium）/ Chrome |
✅ 自带 |
通常已自带；如缺失从 microsoft.com/edge 下载 |
| DOCX 导出 |
pandoc ≥ 2.x |
❌ |
见下方 |
| 打印 |
系统打印 |
✅ 自带 |
无需安装 |
安装 pandoc（仅 DOCX 导出需要）
winget install --id JohnMacFarlane.Pandoc -e
或从 pandoc.org/installing.html 下载安装包。安装完成后需要重启 MD Reader。
如果你只需要 PDF / HTML 导出，不需要安装 pandoc。
开发
环境要求
| 工具 |
版本 |
安装 |
| Node.js |
≥ 18 |
https://nodejs.org/ |
| pnpm |
≥ 8 |
npm install -g pnpm |
| Rust |
≥ 1.77 |
https://rustup.rs/ |
| WebView2 Runtime |
— |
Win10/11 自带 |
| Visual Studio Build Tools |
2019+ |
含 “Desktop development with C++” 工作负载 |
命令
pnpm install
pnpm tauri dev
pnpm tauri build
pnpm lint
pnpm format
技术栈
- 桌面框架: Tauri 2（Rust + WebView2）
- 前端: Vue 3 + TypeScript + Vite
- Markdown: markdown-it + 多个插件
- 编辑器: CodeMirror 6
- 公式: KaTeX
- 图表: Mermaid
- 代码高亮: highlight.js
- PDF 导出: 系统 Edge
--headless=new --print-to-pdf
- DOCX 导出: pandoc
- 文件监听: notify + notify-debouncer-mini
- 全文搜索: walkdir + 流式逐行扫描
- 单例运行 / 文件关联: tauri-plugin-single-instance
- 国际化: vue-i18n
PDF 导出样式
设置 →「PDF 导出」标签页（与阅读设置相互独立），导出 PDF / 打印时套用：
- 24 套预设模板，下拉按组浏览：
- 文档：现代（默认）/ 简约 / 学术 / 护眼 / 商务蓝 / 古典棕 / GitHub 风格
- 开发：暗色 / 终端绿 / Dracula 紫 / VS Code 蓝 / Nord 极光 / Solarized 浅色 / Solarized 深色 / Gruvbox 浅色 / Gruvbox 深色 / Monokai / Catppuccin / One Dark
- 创意：樱花粉 / 薰衣草紫 / 海洋青 / 日落橙 / 森林苔藓
- 间距密度：紧凑 / 标准 / 宽松
- 字体：正文 / 标题 / 代码字体，正文字号、行高
- 颜色：文字、标题、链接、代码背景、页面背景等可自定义
- 页面：A4 / Letter，纵向 / 横向，页边距
- 实时预览：示例文本可编辑、即改即见，支持浅色 / 深色双栏对照
PDF 导出原理
不依赖 LaTeX 或额外的渲染引擎。
- 前端把已渲染的 DOM（KaTeX 公式、Mermaid SVG 已就绪）抓取
- 图片转 base64 内嵌、KaTeX/highlight.js CSS 内嵌
- Rust 写临时 HTML 到
%TEMP%（ASCII 路径）
- 调用系统 Edge headless 模式：
--headless=new --print-to-pdf=...
- Edge 完成后把 PDF 拷贝到用户选择的目标路径
结果：1-3 秒生成，与阅读器视觉完全一致。
常见问题
Q: 启动应用提示缺失 WebView2？
A: 从 https://developer.microsoft.com/microsoft-edge/webview2/ 下载 Evergreen Bootstrapper 安装一次即可。Win10 21H2 及以上、Win11 默认自带。
Q: 导出 PDF 时找不到 Edge？
A: 应用会弹文件选择对话框让你指定 msedge.exe 路径。也可以选择 Chrome（chrome.exe），同样工作。
Q: 导出 DOCX 提示未检测到 pandoc？
A: 安装 pandoc 后重启 MD Reader。
Q: 支持 macOS / Linux 吗？
A: 支持，但目前为实验版本。正式发布的是 Windows 版；macOS / Linux 可通过 GitHub Actions 自行构建（见上方「安装」）。这些实验版未做代码签名。
许可
MIT
评论