nicejade/markdown-online-editor

Arya - 在线 Markdown 编辑器

镜像概述和主要用途

Arya是一款基于Vue2和Vditor构建的在线Markdown编辑器，提供全面的Markdown编辑功能，支持多种图表绘制、媒体内容解析、本地存储及多格式导出。适用于个人写作、技术文档创作、PPT预览等场景，可通过Docker快速部署自托管服务，满足本地或服务器端的Markdown编辑需求。

核心功能和特性

• 基础编辑能力：支持标准Markdown语法解析，实时预览，编辑窗口大小拖拽调整，字符计数
• 高级图表支持：流程图、甘特图、时序图、任务列表、echarts数据图表、五线谱渲染
• 媒体与格式转换：粘贴HTML自动转换为Markdown，支持视频、音频内容解析
• 内容安全保障：编辑内容自动保存至本地存储，防止意外关闭导致内容丢失
• 多编辑模式：所见即所得（⌘-⇧-M/Ctrl-⇧-M）、即时渲染（⌘-⌥-8/Ctrl-alt-8）、分屏渲染（⌘-⌥-9/Ctrl-alt-9）
• 导出与分享：支持导出带样式的PDF、PNG、JPEG文件，提供复制到微信公众号等功能
• PPT预览功能：集成RevealJs，支持通过---（水平幻灯片）和--（垂直幻灯片）创建简单PPT
• 便捷操作：常用快捷键（如Tab）、代码块复制、Markdown语法格式化检查

使用场景和适用范围

• 个人日常Markdown文档编辑与写作
• 技术文档创作（含代码块、图表说明）
• 快速制作和预览简单PPT
• 需要本地存储保障内容安全的编辑场景
• 团队内部共享的Markdown编辑工具
• 静态站点部署（如Cloudflare Pages、Github Pages）

使用方法和配置说明

基本操作

1. 访问编辑器后，清空默认文档即可开始编辑
2. 编辑模式切换：
   • 所见即所得模式：⌘-⌥-7（macOS）/Ctrl-alt-7（Windows/Linux）
   • 即时渲染模式：⌘-⌥-8（macOS）/Ctrl-alt-8（Windows/Linux）
   • 分屏渲染模式：⌘-⌥-9（macOS）/Ctrl-alt-9（Windows/Linux）
   • 快速切换模式：⌘-⇧-M（macOS）/Ctrl-⇧-M（Windows/Linux）

PPT预览使用

1. 通过编辑器"设置"入口启用PPT预览功能
2. 使用---分隔符定义水平方向幻灯片，--定义垂直方向幻灯片
3. 具体格式规范参考https://github.com/hakimel/reveal.js#table-of-contents%EF%BC%88%E6%B3%A8%EF%BC%9A%E6%9A%82%E4%B8%8D%E6%94%AF%E6%8C%81%E5%9B%BE%E8%A1%A8%E6%B8%B2%E6%9F%93%EF%BC%89

Docker部署

直接运行容器

bash
# 基本命令格式
docker run -d -p [宿主机端口]:80 nicejade/markdown-online-editor:[版本标签]

# 示例：本地部署，映射端口8866
docker run -d -p 8866:80 nicejade/markdown-online-editor:latest

访问地址：本地部署为http://localhost:8866，服务器部署为http://[服务器IP]:8866

Docker Compose部署

创建docker-compose.yml文件：

yaml
version: '3'
services:
  markdown-editor:
    image: nicejade/markdown-online-editor:2.1.0  # 可指定具体版本（如latest）
    ports:
      - "8866:80"  # 左侧为宿主机端口，右侧固定为80
    restart: always  # 容器退出时自动重启

在文件目录执行启动命令：

bash
docker-compose up -d