一、它是什么

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 的差异化在于把多个垂直功能塞进了一个浏览器页面,而且全部免费、全部开源:

对比维度AryaTypora飞书文档
价格免费开源付费($14.99)免费(SaaS)
部署方式浏览器 / Docker 私有化本地安装云端
数据存储本地 localStorage本地文件云端
图表支持流程图/甘特图/时序图/五线谱/EchartsMermaid(有限)有限
PPT 预览✓ Reveal.js✗✗
HTML→MD✓ 粘贴自动转换✗✗
音视频解析✓✗有限
导出格式PDF/PNG/JPEG/DOCX/微信HTMLPDF/HTML/Word/ImagePDF/Word
私有化部署✓ Docker✗(桌面软件)✗

核心优势:零安装 + 全功能 + 数据不出本地 + 可私有化。对于注重隐私或需要内网部署的团队,Docker 一行命令就能拉起。

三、核心功能拆解

图表绘制

基于 Vditor 内置的 mermaid 和 abcjs 引擎,Arya 支持在 Markdown 中直接写图表语法:

图表类型语法适用场景
流程图```mermaid graph TD业务流程、决策树
甘特图```mermaid gantt项目排期、里程碑
时序图```mermaid sequenceDiagramAPI 交互、系统调用
Echarts 图表```echarts数据可视化、统计图
五线谱```abc乐谱排版

PPT 预览(Reveal.js)

在设置中开启 PPT 模式后,Markdown 文档可以变成幻灯片演示:

  • 用 --- 分隔水平幻灯片
  • 用 -- 分隔垂直幻灯片
  • 支持 Reveal.js 的全部主题和过渡动画
  • 注意:PPT 模式下图表无法渲染,需要在普通模式下完成图表再切换

HTML 自动转 Markdown

从网页、Word、富文本编辑器复制内容后直接粘贴,Arya 自动把 HTML 转成 Markdown 语法。这个功能在整理外部素材时极为实用——不用手动清理格式,粘贴即转换。

音视频解析

支持在文档中嵌入部分站点的视频和音频链接,自动解析为可播放的内嵌播放器。

多格式导出

导出格式说明
PDF携带样式,适合打印和分享
PNG / JPEG长图截图,适合社交媒体
DOCXWord 格式,适合协作
微信 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 是目前最完整的开源选择之一。

返回技艺录