一、它是什么
Arya 是一款纯浏览器端的在线 Markdown 编辑器,名字取自「二丫」——开发者 nicejade 因为市面上 Markdown 编辑器要么功能不全要么高级功能收费,于是基于黑客派出品的 Vditor 引擎,用 Vue2 框架包了一层,做成了这个功能齐全、完全免费、数据不出本地的工具。
| 属性 | 详情 |
|---|---|
| 仓库地址 | github.com/nicejade/markdown-online-editor |
| 官网 | markdown.lovejade.cn |
| 备用地址 | arya.pages.dev(Cloudflare Pages) |
| 协议 | MIT(可商用) |
| 技术栈 | Vue2 + Vditor + Reveal.js |
| 代码构成 | CSS 89.1% / JS 6.2% / Vue 3.7% / Less 0.5% |
| 维护方 | nicejade(2018 年至今持续维护) |
| 数据存储 | 浏览器 localStorage,不上传服务器 |
一句话定位:浏览器打开就能用的「全功能 Markdown 工作台」——写文档、画图、做 PPT、导出多格式,不装软件、不传数据。
二、为什么选 Arya
市面上的 Markdown 编辑器不少,Arya 的差异化在于把多个垂直功能塞进了一个浏览器页面,而且全部免费、全部开源:
| 对比维度 | Arya | Typora | 飞书文档 |
|---|---|---|---|
| 价格 | 免费开源 | 付费($14.99) | 免费(SaaS) |
| 部署方式 | 浏览器 / Docker 私有化 | 本地安装 | 云端 |
| 数据存储 | 本地 localStorage | 本地文件 | 云端 |
| 图表支持 | 流程图/甘特图/时序图/五线谱/Echarts | Mermaid(有限) | 有限 |
| PPT 预览 | ✓ Reveal.js | ✗ | ✗ |
| HTML→MD | ✓ 粘贴自动转换 | ✗ | ✗ |
| 音视频解析 | ✓ | ✗ | 有限 |
| 导出格式 | PDF/PNG/JPEG/DOCX/微信HTML | PDF/HTML/Word/Image | PDF/Word |
| 私有化部署 | ✓ Docker | ✗(桌面软件) | ✗ |
核心优势:零安装 + 全功能 + 数据不出本地 + 可私有化。对于注重隐私或需要内网部署的团队,Docker 一行命令就能拉起。
三、核心功能拆解
图表绘制
基于 Vditor 内置的 mermaid 和 abcjs 引擎,Arya 支持在 Markdown 中直接写图表语法:
| 图表类型 | 语法 | 适用场景 |
|---|---|---|
| 流程图 | ```mermaid graph TD | 业务流程、决策树 |
| 甘特图 | ```mermaid gantt | 项目排期、里程碑 |
| 时序图 | ```mermaid sequenceDiagram | API 交互、系统调用 |
| Echarts 图表 | ```echarts | 数据可视化、统计图 |
| 五线谱 | ```abc | 乐谱排版 |
PPT 预览(Reveal.js)
在设置中开启 PPT 模式后,Markdown 文档可以变成幻灯片演示:
- 用
---分隔水平幻灯片 - 用
--分隔垂直幻灯片 - 支持 Reveal.js 的全部主题和过渡动画
- 注意:PPT 模式下图表无法渲染,需要在普通模式下完成图表再切换
HTML 自动转 Markdown
从网页、Word、富文本编辑器复制内容后直接粘贴,Arya 自动把 HTML 转成 Markdown 语法。这个功能在整理外部素材时极为实用——不用手动清理格式,粘贴即转换。
音视频解析
支持在文档中嵌入部分站点的视频和音频链接,自动解析为可播放的内嵌播放器。
多格式导出
| 导出格式 | 说明 |
|---|---|
| 携带样式,适合打印和分享 | |
| PNG / JPEG | 长图截图,适合社交媒体 |
| DOCX | Word 格式,适合协作 |
| 微信 HTML | 微信公众号特制格式,直接粘贴到编辑器 |
其他实用功能
- 插入原生 Emoji + 常用表情列表
- 代码块一键复制按钮
- Markdown 语法检查与格式化
- 字符计数、主窗口大小拖拽
- 内置多种漂亮样式,支持自定义 CSS
- 编辑内容自动保存本地存储,防意外丢失
四、三种编辑模式
Arya 默认使用「所见即所得」模式,可通过快捷键自由切换:
| 模式 | 快捷键 | 特点 | 适合场景 |
|---|---|---|---|
| 所见即所得 | Ctrl+Alt+7 | 编辑即渲染,像 Word 一样写 Markdown | 日常写作、不熟悉语法 |
| 即时渲染 | Ctrl+Alt+8 | 输入 Markdown 语法后实时渲染 | 熟悉语法的开发者 |
| 分屏渲染 | Ctrl+Alt+9 | 左侧 Markdown 源码 + 右侧预览 | 校对、排版检查 |
macOS 用户将 Ctrl 替换为 ⌘、Alt 替换为 ⌥。也可以用 Ctrl+Shift+M 快速在模式间循环切换。
五、部署方式
方式一:直接使用在线版
打开 markdown.lovejade.cn 即可使用,无需注册、无需安装。
方式二:Docker 私有化部署
官方已将镜像发布至 Docker Hub,一行命令拉起:
docker run -d -p 8866:80 nicejade/markdown-online-editor
本地访问 http://localhost:8866,服务器部署则用 http://[Server-IP]:8866,配域名走反向代理即可。
方式三:源码自行构建
git clone https://github.com/nicejade/markdown-online-editor.git
cd markdown-online-editor
yarn install
yarn start # 开发
yarn deploy # 部署到 GitHub Pages(需改 commands/deploy.sh)
注意:项目使用 prerender-spa-plugin 解决 SPA SEO 问题,部署时需在根目录创建 arya.config.js 指定 Chromium 路径(参考 arya.config.sample.js)。
方式四:Cloudflare Pages
Fork 仓库后通过 Cloudflare Pages 自动构建部署,备用地址 arya.pages.dev 即此方式。
六、玩一玩
以下是几条实操路线,从不同角度体验 Arya 的能力:
路线 A:5 分钟体验全功能
1. 打开 markdown.lovejade.cn
2. 清空默认文档,粘贴一段带格式的网页内容(测试 HTML→MD 转换)
3. 插入一个 mermaid 流程图代码块
4. 用 Ctrl+Alt+9 切到分屏模式对比源码和渲染
5. 导出为 PNG 长图
收获:5 分钟内走完「粘贴→编辑→图表→预览→导出」全链路。
路线 B:用 Markdown 做 PPT
1. 写好内容后,用 --- 把内容分成多页
2. 在设置中开启 PPT 预览模式
3. 用方向键翻页,体验 Reveal.js 的过渡动画
4. 调整每页内容量,确保单页不超载
5. 导出 PDF 作为离线版幻灯片
收获:以后做技术分享不用再开 PowerPoint,Markdown 写完即演示。
路线 C:Docker 私有化部署到团队内网
1. 在内网服务器执行 docker run -d -p 8866:80 nicejade/markdown-online-editor
2. 配置 Nginx 反向代理 + 域名 + HTTPS
3. 团队成员浏览器访问即可使用
4. 数据只存在各自浏览器本地,服务器不存任何用户内容
收获:零成本给团队提供一个内网 Markdown 工作台,数据不出内网。
七、适合谁 & 注意点
适合:
- 经常写技术文档、博客的开发者——图表 + 代码块 + 导出全搞定
- 公众号作者——微信特制 HTML 导出,直接粘贴到公众号编辑器
- 需要做技术分享的人——Markdown 写完直接 PPT 演示
- 注重数据隐私的个人或团队——本地存储 + Docker 私有化
- 需要从网页/Word 整理素材的人——HTML 自动转 Markdown 省去手动清理格式
- 学 Vue2 前端的人——源码开源,CSS 占 89% 是学习样式实现的好素材
注意:
- 数据存在 localStorage。清浏览器缓存会丢内容。重要文档记得导出备份。刷新页面不会丢——只有主动清缓存才会。
- Vue2 已进入维护模式(Vue 官方主推 Vue3),但 Vditor 引擎本身仍在活跃迭代,功能不受影响。
- PPT 预览模式下图表无法渲染,需要先在编辑模式确认图表正确再切 PPT。
- Docker 镜像是打包好的静态文件服务,不含后端——意味着多人协作、云同步这类功能没有,它是纯前端工具。
- 音视频解析支持的范围有限,不是所有平台都能解析。
- 项目从 2018 年持续维护至今,作者 nicejade 是活跃的前端开发者,同时也是「倾城之链」等项目的维护者。
定位:Arya 不是要替代 Typora 或飞书文档,它的核心价值是浏览器打开即用 + 全功能 + 零数据上传 + 可私有化。如果你需要一个「随时可用、功能齐全、数据自己掌控」的 Markdown 工作台,Arya 是目前最完整的开源选择之一。
返回技艺录