Languages: 简体中文 | 繁體中文 | English | 日本語

ReadMD

Open huge Markdown files locally. Keep the original untouched.

ReadMD 是本地优先的 Markdown 阅读器和编辑器：双击即读，超长文档不假死，常见语法错误只在显示层修复；支持 Office / PDF / 网页转 MD、离线 OCR、LaTeX 学术增强和 MCP 接入。

30 秒判断它适不适合你

直接下载

Windows 安装包 ·
Windows 便携版 ·
macOS Apple Silicon ·
macOS Intel ·
Linux AppImage ·
UOS / 麒麟 Deb ·
SHA-256

三步开始

1. 按系统下载安装包，或选择免安装便携版。
2. 打开一个真实的大文件；先检查目录、搜索和表格渲染。
3. 需要修改时再编辑保存；自动修复不会在你不知情时改写源文件。

为什么值得 Star

ReadMD 解决的是长期资料库里的实际问题：大文件能继续读，导入稿不用重排，敏感内容可以留在本机，原文始终保留最终决定权。如果你在 Windows、macOS、Linux 或信创环境之间切换，它提供一致的工作流。

如果它帮你省下一次整理时间，请 点 Star，让更多写作者找到这个项目。

🚀 全平台直接下载矩阵 (Release Assets)

💻 多系统与信创国产 / 鸿蒙深度适配

1. Linux 与国产操作系统适配（统信 UOS / 银河麒麟 / 深度 / openEuler）

• 直接安装使用：下载 readmd_2.3.7-beta.3_amd64.deb 双击安装，或直接运行 ReadMD-linux-x86_64-v2.3.7-beta.3.AppImage。
• 系统与环境识别：src/readmd_modules/linux_native.py 自动识别系统发行版，自适应配置 Wayland / X11 显示后端。
• 桌面与深色模式：自动侦测 DDE（统信/Deepin）、UKUI（银河麒麟）与 GNOME/KDE 的外观主题，实时同步深色/浅色配色。
• 桌面集成与关联：内置 FreeDesktop 桌面入口与 MIME 类型声明，支持双击 .md 默认打开。
• 玲珑分发格式：提供 packages/linglong/linglong.yaml，适配统信应用商店分发。

2. HarmonyOS NEXT (纯血鸿蒙) 与 OpenHarmony 原生应用

• 应用包安装：直接下载 ReadMD-harmonyos-v2.3.7-beta.3.hap 或使用 DevEco Studio NEXT 打开 packages/harmonyos-app/ 编译。
• ArkUI + ArkWeb 架构：通过 ArkWeb 容器完整复用 ReadMD 离线渲染核心（Marked + KaTeX + 46 语种 i18n + LaTeX PRO）。
• 系统能力桥接 (ReadMDBridge.ets)：
  • 系统剪贴板交互 (@ohos.pasteboard)；
  • 原生文件选择与保存 (@ohos.file.picker / @ohos.file.fs)；
  • 系统区域语言自适应检测 (@ohos.i18n)；
  • 鸿蒙原生离线文字识别 (@ohos.ai.OCR)。

3. Windows & macOS 平台特性

• Windows：内置 WinRT 原生 OCR、WebView2 硬件加速渲染、系统托盘常驻与智能单实例通信。
• macOS：原生 Apple Vision 离线文字识别、WebKit 视窗引擎、跟随系统外观与 Touch Bar 快捷操作。

🧩 VSCode 扩展与 MCP Server 生态

1. VSCode 插件安装与使用

• 界面安装：下载 readmd-vscode-2.3.7-beta.3.vsix -> 在 VSCode 扩展面板选择 ... -> 从 VSIX 安装...。
• 命令行安装：

  code --install-extension readmd-vscode-2.3.7-beta.3.vsix
  

• 核心功能：打开 Markdown 文件点击右上角书本图标开启同步预览；右键菜单支持一键自动修复语法错误与转换为 LaTeX 源码。

2. MCP (Model Context Protocol) Server 配置

直接下载解压 readmd-mcp-server-2.3.7-beta.3.zip，在 Claude Desktop、Cursor、Antigravity 与 Cline 中配置：

{
  "mcpServers": {
    "readmd": {
      "command": "python",
      "args": ["packages/mcp-server/readmd_mcp_server.py"]
    }
  }
}

📐 LaTeX PRO 学术增强与 BibTeX 引用

1. BibTeX 自动扫描与引用卡片：
   • 自动扫描同目录下 .bib 参考文献文件；
   • 文中书写 [@vaswani2017attention] 或 @author2024 自动渲染为引用徽章；
   • 悬停徽章展示论文标题、作者、年份、DOI 链接并支持一键复制 BibTeX；文末自动汇总生成参考文献表。
2. 学术 Callout 盒子：
   • ::: theorem [定理名称] / ::: lemma [引理名称] / ::: definition [概念定义]
   • ::: proof 证明块自动添加文末 Q.E.D. ■ 符号。

🧘 Editor Studio PRO 沉浸编辑

• Zen Mode 禅模式：按 F11 或点击编辑栏「🧘 禅模式」全屏专注写作，按 Esc 退出。
• 10×10 可视化表格设计器：鼠标自由滑选行列生成工整 Markdown 表格。
• 智能表格粘贴：复制 Excel、WPS、Numbers 或网页表格，在编辑器中直接粘贴为 Markdown 表格。
• 实时文档统计：实时显示中文字数、西文词数与预计阅读时间。

🌍 全球 46 语种 i18n 全量母语化

ReadMD 完整支持 46 种语言，初次启动自适应系统语言，通过独立真伪审计（≥97% 真实母语率），零英文 fallback。

📖 详细规范与词条清单：docs/i18n-language-reference.md

🧠 核心功能与使用指南

• 自动修正：表格缺线对齐补全、加粗与公式未闭合自动闭合、#标题 补空格，修正详情在「🛠 修复」面板中清晰展示。
• 万物转 MD：支持 Word、PowerPoint、Excel、PDF、HTML、LaTeX 等批量或拖拽转换，转换后自动在新标签页打开。
• 扫描 OCR：Windows (WinRT) 与 macOS (Vision) 本地离线识别，剪贴板截图一键提取文字。
• 网页转 MD：Trafilatura 智能抽取正文，动态单页应用自动通过无头 WebView 渲染提取。
• 局域网共享：点击工具栏「📱」生成二维码与随机密钥，手机扫码在同 Wi-Fi 下阅读与编辑。

⌨️ 常用快捷键

📦 架构与源码构建

readmd/
├─ readmd.py                     # 主程序入口（本地 Web 服务 + 视窗 + 托盘常驻）
├─ src/                          # 核心算法与原生适配层
│  ├─ readmd_fix.py              #   Markdown 自动修正引擎
│  └─ readmd_modules/            #   原生平台适配 (linux_native.py) / OCR / 转换 / AI
├─ packages/                     # 多端生态分包
│  ├─ vscode-extension/          #   VSCode 官方扩展
│  ├─ mcp-server/                #   FastMCP (stdio) 服务端
│  ├─ harmonyos-app/             #   HarmonyOS NEXT (ArkTS) 鸿蒙原生应用
│  └─ linglong/                  #   统信 UOS 玲珑容器打包配置
├─ scripts/                      # 打包与构建脚本 (windows / linux / unix)
├─ assets/                       # 前端渲染、主题 token 与 46 语种 i18n 资源
├─ docs/                         # 语言对照清单与开发文档
└─ tests/                        # 单元测试与回归套件 (151 项全通过)

本地构建与运行：

• Windows：运行 scripts\windows\install.bat 安装依赖，scripts\windows\run.bat 运行；scripts\windows\package.bat 打包。
• Linux：运行 bash scripts/linux/build_linux.sh 打包 AppImage 与 Deb 安装包。
• macOS：运行 ./install.sh 安装依赖，./setup.sh 构建 ReadMD.app。
• 鸿蒙：使用 DevEco Studio NEXT 打开 packages/harmonyos-app 进行编译。

📝 更新日志 (v2.3.7-beta.1)

• 🌍 46 语种全量母语化与机翻清洗：深入审核 42 个非中英文语言字典，消除波兰语混淆、西部之塔、农作物裁剪等全部系统性翻译错误，实现 100% 完整覆盖。
• 🐧 Linux 全架构与信创国产系统支持：新增 linux_native.py 原生模块，适配银河麒麟 KylinOS V10 SP2、统信 UOS 20、深度 Deepin、openEuler；提供 FreeDesktop 桌面集成与玲珑容器声明。
• 📱 HarmonyOS NEXT 鸿蒙原生应用分包：基于 ArkTS + ArkUI + ArkWeb 构建，系统级桥接剪贴板、文件选择器与原生 OCR。
• 📐 LaTeX PRO 学术论文套件：零配置 .bib 参考文献浮动卡片、学术 Callout 盒子与 LaTeX 导出。
• 🧘 Editor Studio PRO 体验重塑：Zen 禅模式全屏专注、10×10 表格设计器、Excel 智能转换。
• 🔌 VSCode 插件与 MCP Server 生态完善：升级至 v2.3.7-beta.1，提供稳定的多端 AI 写作协作流。

❓ 常见问题

• Q: 为什么双击打开速度极快？
  • A: 安装版为 onedir 目录部署，启动无需临时解压；关闭后常驻系统托盘，二次打开通过轻量本地通信在 0.3s 内瞬间唤醒。
• Q: 打开未签名安装包被系统拦截怎么办？
  • A: Windows 在 SmartScreen 提示点击「更多信息 → 仍要运行」；macOS 首次打开在 Finder 中右键 ReadMD.app 选择「打开」。请核对 SHA256SUMS.txt 校验码。
• Q: 文档格式自动修正常见错误会改写我的原始文件吗？
  • A: 绝不会。自动修正仅发生在内存渲染阶段，原 .md 源码保持 100% 完好无损。