MdEv

MdEv 是一款基于 Electron + Vue 3 + CodeMirror 6 构建的 Windows 桌面端 Markdown 编辑器。它开箱即用，无需联网，所有文件操作均在本地完成，适合日常写作、技术文档编写、笔记整理等场景。

• 纯本地 — 所有文件操作在本地完成，数据不离开你的电脑，隐私安全有保障
• 所见即所得 — 左编辑右预览实时同步，滚动联动，写作体验流畅
• 功能完备 — 内置数学公式、代码高亮、Mermaid 图表、PlantUML、目录导航、全文搜索
• 开箱即用 — 下载即用，无需配置环境，也无需联网

• ✅ CodeMirror 6 编辑器 — 语法高亮、搜索替换、括号匹配、代码折叠
• ✅ 撤销 / 重做 — 完整编辑历史，工具栏按钮 + 快捷键
• ✅ 自动保存 — 防抖自动写盘，状态栏实时显示保存状态
• ✅ 自动换行 — 可切换软换行模式，单回车即换行（与 Typora 一致）
• ✅ 图片拖拽插入 — 直接拖拽图片到编辑区自动插入 Markdown 语法

• ✅ 实时预览 — markdown-it 渲染 + KaTeX 数学公式 + highlight.js 代码高亮
• ✅ Mermaid 图表 — 流程图、甘特图、时序图等
• ✅ PlantUML 渲染 — 通过 PlantUML 服务器渲染 UML 图
• ✅ 数学公式 — 行内公式 ($...$) + 块级公式 ($$...$$)，支持模板快速插入
• ✅ 扩展语法 — 下标、上标、高亮标记、脚注、Admonition (::: tip / ::: warning 等)
• ✅ 本地图片渲染 — 自定义 mdimg:// 协议，直接显示本地相对路径图片
• ✅ 预览区点击 — 点击本地文件链接可直接用系统程序打开

• ✅ 丰富工具栏 — 文字 / 标题 / 段落 / 插入 / 表格 / 公式 / 操作，7 大分组下拉菜单
• ✅ 快捷按钮栏 — 10 个常用操作一键直达（加粗 / 斜体 / 标题 / 链接 / 图片 / 代码块 / 表格 / 撤销 / 重做）
• ✅ 表格操作 — 可视化选择行列数插入表格、行/列增删
• ✅ 公式模板 — 行内 / 块级公式模板快速插入，6 种常用数学表达式模板
• ✅ 图片插入 — 文件选择框 + 拖拽插入 + 网络图片 URL 弹窗
• ✅ 链接插入 — 弹窗输入链接描述 + 地址

• ✅ 工程目录管理 — 打开文件夹，文件树浏览、新建文件 / 文件夹
• ✅ 多标签页 — 拖拽排序、未保存标记、右键菜单关闭
• ✅ 最近打开 — 最近文件 / 文件夹快速访问，文件菜单 + 侧边栏双重入口
• ✅ 默认恢复 — 启动时自动打开上次的文档和文件夹
• ✅ 文件类型支持 — Markdown、JSON、图片（图片用系统查看器打开）

• ✅ 目录导航 — 自动提取标题树，点击跳转章节
• ✅ 全文搜索 — 文件内搜索 (Ctrl+F) + 跨文件搜索 (Ctrl+Shift+F)
• 📋 TOC 滚动自动高亮当前章节 — 计划中
• 📋 搜索词预览区高亮 — 计划中

• ✅ 主题切换 — 浅色 / 深色 / 跟随系统，侧边栏太阳/月亮图标一键切换
• ✅ 字体设置 — 编辑器 / 预览区独立字体选择，侧边栏 A+/A− 快捷调节字号
• ✅ 设置面板 — 外观 / 编辑器 / 预览 / 文件，4 大分区，齿轮图标入口

• ✅ 导出 PDF — 公式与样式完整保留
• ✅ 导出 HTML — 独立 HTML 文件，可离线查看
• 📋 PDF 自定义页眉页脚 — 计划中
• 📋 导出进度指示 — 计划中

• ✅ 品牌标识 — 标题栏 logo + 软件名称 MdEv
• ✅ 侧边栏图标 — Lucide 风格线条图标，清晰易辨
• ✅ 关于弹窗 — 含 GitHub 仓库链接

前往 Releases 页面 下载最新版本的 MdEv-Setup-0.2.0.exe，双击即可安装运行。

也可下载便携版 MdEv 0.2.0.exe，无需安装，双击即用。

适合开发者或希望自行编译的用户。

• Node.js ≥ 18（推荐 20 LTS）
• npm ≥ 9

# 克隆仓库
git clone https://github.com/wrrgit/MdEv.git
cd MdEv

# 安装依赖
npm install

# 开发模式（Electron + Vite HMR）
npm run electron:dev

# 打包为 Windows 安装包（NSIS）
npm run make

# 或打包为便携版（portable）
npm run package

打包产物位于 release/ 目录下。

MdEv/
├── electron/               # Electron 主进程
│   ├── main.js             # 窗口管理、IPC、自定义协议
│   └── preload.cjs         # 安全桥接（Context Isolation）
├── src/                    # 渲染进程（Vue 3）
│   ├── components/         # UI 组件
│   │   ├── TitleBar.vue          # 自定义标题栏（logo + 软件名）
│   │   ├── MenuBar.vue           # 菜单栏（含最近打开子菜单）
│   │   ├── TabBar.vue            # 标签页
│   │   ├── Toolbar.vue           # 工具栏（7 分组 + 快捷栏）
│   │   ├── FileTree.vue          # 文件树
│   │   ├── EditorPane.vue        # 编辑器面板
│   │   ├── PreviewPane.vue       # 预览面板
│   │   ├── PanelSidebar.vue      # 侧栏（文件树/最近/目录/搜索 + 主题/字体/设置）
│   │   ├── SettingsPanel.vue     # 设置面板
│   │   ├── ExportDialog.vue      # 导出对话框
│   │   ├── StatusBar.vue         # 状态栏
│   │   └── WelcomePage.vue       # 欢迎页
│   ├── composables/       # 组合式函数（导出、主题）
│   ├── core/              # Markdown 解析核心
│   ├── stores/            # Pinia 状态管理
│   ├── config/            # 工具栏配置
│   └── styles/            # CSS 变量主题
├── build/                  # 应用图标资源
├── docs/                   # 项目文档
├── package.json
├── vite.config.js
└── README.md

详见 ROADMAP.md。

欢迎提交 Issue 和 Pull Request！

提交前请确保：

1. 遵循 Conventional Commits 规范
2. 代码风格与现有代码保持一致
3. 更新相关文档

本项目基于 Apache License 2.0 开源。

Copyright © 2026 wrrgit