<p style="text-align: center; margin: 2rem 0;">
<a href="https://umodoc.com" target="_blank"><img src="https://unpkg.com/@umoteam/editor-external@latest/static/logo.svg" alt="umodoc.com" width="280" /></a>
</p>

<p style="text-align: center;">
<a href="https://github.com/umodoc/editor/blob/main/LICENSE" target="_blank"><img src="https://img.shields.io/npm/l/@umoteam/editor" /></a>
<a href="https://www.npmjs.com/package/@umoteam/editor" target="_blank"><img src="https://img.shields.io/npm/v/@umoteam/editor" /></a>
<a href="https://www.npmjs.com/package/@umoteam/editor" target="_blank"><img src="https://img.shields.io/npm/d18m/@umoteam/editor" /></a>
<a href="https://www.npmjs.com/package/@umoteam/editor" target="_blank"><img src="https://img.shields.io/npm/unpacked-size/%40umoteam%2Feditor" /></a>
<a href="https://github.com/umodoc/editor/commits" target="_blank"><img src="https://img.shields.io/github/commit-activity/m/umodoc/editor" /></a>
</p>

## 基本介绍

Umo Editor 是一个基于 Vue3 和 Tiptap 的适合于国人使用的本土化开源文档编辑器。Umo Editor 提供完善的文档编辑能力和 AI 创作能力，支持分页，支持 Markdown 语法，支持基础的富文本编辑功能，支持多种插入多种格式的节点类型、提供了多种类型的实用工具，并支持设置页面的样式，支持导出多种类型的格式，支持打印和打印预览，支持文档块编辑，支持添加自定义扩展，支持多语言设置，支持暗色主题。

<img src="https://unpkg.com/@umoteam/editor-external@latest/static/umo-editor-cn@2x.png" alt="umo editor" />

作为一个独立的 Vue3 插件，Umo Editor 可以零配置轻松集成到各类 Vue3 项目中，对于非 Vue3 项目，您可以通过 Iframe 将 Umo Editor 嵌入到您的项目中。

## 快速开始

[开发文档](https://editor.umodoc.com/cn/docs) | [在线演示](https://demo.umodoc.com/editor?lang=zh-CN) | [GitHub](https://github.com/umodoc/editor) | [码云(国内镜像)](https://gitee.com/umodoc/editor) | [NPM](https://www.npmjs.com/package/@umoteam/editor)

## 在线体验

访问 [在线演示](https://demo.umodoc.com/editor?pane=hide&lang=zh-CN) 快速体验。

## 开发文档

请访问 [开发文档](https://editor.umodoc.com/cn/docs) 。

## 设计理念

Umo Editor 的诞生，旨在解决 Web 应用中文档编辑的复杂性，为 Web 项目提供开源免费的类似 Microsoft Word 的强大编辑能力和分页模式，同时保持 Web 应用的便捷性。无论是政企信息管理系统、学术研究撰写、团队文档协作、知识库管理还是个人笔记整理，Umo Editor 都能成为您得力的助手。

## 开源优势

- **免费使用**：作为开源项目，Umo Editor 基于 [MIT 许可证](https://github.com/umo-editor/umo-editor/blob/main/LICENSE) 对所有开发者免费开放，无需担心版权问题。

- **持续更新**：Umo Editor 将持续迭代，不断优化功能，提升用户体验。

- **定制化开发**：开源意味着更大的灵活性，开发者可根据项目需求进行定制化开发，打造专属的文档编辑器。

## 核心特性

- 零配置开箱即用
- 类似于与 Microsoft Word 的分页模式
- 轻量级
- 全过程所见即所得
- 富文本编辑功能
- Markdown 语法支持
- 实用工具集成
- 演示模式
- 页面设置
- AI 文档助手
- 文档导出与分享
- 气泡菜单与块级菜单
- 快捷键支持
- 支持打印及打印预览
- 主题定制
- 多语言设置
- 暗色主题

更多详细介绍见 [核心特性](https://editor.umodoc.com/cn/docs/features)。

## 浏览器支持

| 浏览器                   |  版本  | 支持情况  |
| ------------------------ | :----: | :-------: |
| Google Chrome            | 最新版 |  ✅ 支持  |
| Firefox                  | 最新版 |  ✅ 支持  |
| Safari                   | 最新版 |  ✅ 支持  |
| Microsoft Edge           | 最新版 |  ✅ 支持  |
| 360 极速浏览器           | 最新版 |  ✅ 支持  |
| 各类国产浏览器的极速模式 | 最新版 |  ✅ 支持  |
| Internet Explorer (IE)   |  所有  | ❌ 不支持 |

## Nodejs 版本支持

Nodejs 18.0.0 及以上版本。

## 加入社区

我们鼓励用户加入 Umo Editor 的开源社区，共同参与到产品的开发和改进中来。无论是提交 Bug 报告、功能请求还是代码贡献，都是我们社区宝贵的一部分。

您可以通过 [https://github.com/umodoc/editor/discussions](https://github.com/umodoc/editor/discussions) 提交问题或意见。

或通过 [https://github.com/umodoc/editor/issues](https://github.com/umodoc/editor/issues) 提交 Bug 报告。

## 贡献代码

### 贡献者名单

Umo Editor 的发展，离不开社区的支持，以下是为 Umo Editor 贡献过代码的贡献者名单，向他们致谢：

- [Umo Team](https://github.com/umodoc)：👨‍💻 核心开发者
- [Cassielxd](https://github.com/Cassielxd)：💪🏻 为 Umo Editor 实现了分页和很多重要的功能
- [Na'aman Hirschfeld](https://github.com/Goldziher)：💪🏻 增强对 TypeScript 的支持，添加测试，为 Umo Editor 的发展提供更好的基础
- [SerRashin](https://github.com/SerRashin): 🛠️ 为 Umo Editor 添加了俄语支持
- [ChenErik](https://github.com/ChenErik): 🛠️ 为 Umo Editor 贡献了部分代码
- [china-wangxu](https://github.com/china-wangxu): 🛠️ 为 Umo Editor 贡献了部分代码
- [Sherman Xu](https://github.com/xuzhenjun130): 🛠️ 为 Umo Editor 贡献了部分代码

我们欢迎任何形式的贡献，包括但不限于提交 Bug 报告、功能请求、代码贡献等。

## 联系我们

如果您有任何疑问或建议，请通过以下方式联系我们：

- 反馈：[https://github.com/umodoc/editor/issues](https://github.com/umodoc/editor/issues) | [https://gitee.com/umodoc/editor/issues](https://gitee.com/umodoc/editor/issues)
- 社区：[https://github.com/umodoc/editor/discussions](https://github.com/umodoc/editor/discussions)
- 邮件：[contact@umoteam.com](mailto:contact@umoteam.com)

## QQ 技术交流群：

- [Umo Editor 技术交流1群：994500039](https://qm.qq.com/cgi-bin/qm/qr?k=BH_TYEK3Om0BkN4VMT9TQLRvHzEhkUvp&jump_from=webapi&authKey=xIMvInBso7hjJHh8+44+8IMHhLjvpegQJC0wFtZRir76+vgrBFcw98FVoqCxV7XX)

## 支持我们

如果您觉得 Umo Editor 有用，请考虑通过以下方式支持我们：

- ⭐ 给 [Umo Editor 仓库](https://github.com/umodoc/editor) 点个 Star，表示对项目的支持。
- 🔗 如果您在项目中使用了 Umo Editor，请添加一个链接到 [https://github.com/umodoc/editor](https://github.com/umodoc/editor)。

## 定制开发

如果您需要定制化开发，请联系我们，我们可以提供付费的定制化解决方案。

## 开源协议

Umo Editor 采用 [MIT 许可证](./LICENSE)，您可以免费使用、修改和使用本软件。
