# Univer Docs 简介

> Univer Docs 是 Univer Office SDK 的电子文档组件，支持浏览器和 Node.js，具有灵活、可扩展和可定制的特性。

- Human documentation: [https://docs.univer.ai/zh-CN/guides/docs](https://docs.univer.ai/zh-CN/guides/docs)

- Agent Markdown: [https://docs.univer.ai/zh-CN/guides/docs.md](https://docs.univer.ai/zh-CN/guides/docs.md)

- Requested language: `zh-CN`

- Content language: `zh-CN`

- Documentation version: `1.0.0-rc.0`

- Source: [docs/index.zh-CN.mdx](https://github.com/dream-num/documentation/blob/dev/content/guides/docs/index.zh-CN.mdx)

---

## Univer Docs 是什么

Univer Office SDK 是一个用于构建生产力应用程序的全栈框架，Univer Docs 是 Web SDK 的电子文档组件。

Univer Office SDK 包含三个 SDK：[Web SDK](https://docs.univer.ai/zh-CN/guides/sheets.md) 提供嵌入式编辑器和无头内容处理能力，[Server SDK](https://docs.univer.ai/zh-CN/server.md) 提供协同与文件导入导出能力，[AI SDK](https://docs.univer.ai/zh-CN/ai.md) 提供 Agent 工作流能力。

Univer Docs 可以在浏览器和服务器（Node.js）上运行，并且拥有灵活、可扩展和可定制的特性，你可以用它构建各种应用程序，无论是简单的文字录入还是企业级的复杂排版。无论你是个人开发者还是团队的一员，Univer Docs 都可以帮助你快速轻松地构建强大的基于电子文档的应用程序。

## 浏览器兼容性

Web SDK 的编译目标是 Chrome 88，但这并不意味着 Web SDK 能够完全支持所有主流环境。我们会尽力确保 Web SDK 在以下浏览器和 Node.js 环境中能够正常运行：

| Edge | Firefox | Chrome | Safari | Electron |
| ---- | ------- | ------ | ------ | -------- |
| >=88 | >=90    | >=88   | >=14.1 | >=12     |

> [!WARNING]
> Web SDK 依赖 `Intl.Segmenter`，如果你的浏览器或运行时环境暂不支持它，请先补充对应的 polyfill。我们推荐使用
> `@formatjs/intl-segmenter`。

如果遇到无法兼容的情况，请先借助对应的 polyfill 来解决，如果仍然无法解决，请[提交 issue](https://github.com/dream-num/univer/issues/new/choose)。

## Node.js 兼容性

> [!WARNING]
> 以下仅适用于在 Node.js 环境中运行 Web SDK 的情况，并不适用于那些基于 Node.js 使用构建工具在浏览器中运行 Web SDK 的情况。

Web SDK 可以在 Node.js 环境中运行，支持的版本为 v18.17.0 及之后的版本。

## 主要功能

Univer Docs 现在支持广泛的功能，包括：

* **基本电子文档功能**：支持全文排版，包括段落设置，段前后间距、段落对齐、缩进和悬挂等，也包括段落中的排版能力，标点挤压、标点悬挂、字偶间距、西文断词等。
* **页眉页脚**
* **浮动图片**
* **超链接**
* 以及更多...

请参阅 [功能](https://docs.univer.ai/zh-CN/guides/docs/features/core.md) 部分下的页面以了解详情。

## 如何使用这些文档

在屏幕的左侧是文档导航栏。文档页面按从基础到高级的顺序组织，你可以按照这个顺序循序渐进地了解 Web SDK，或者跳到你感兴趣的章节。你还可以在侧边栏的顶部切换 Univer Docs 的文档。

屏幕的右侧是当前页面的大纲。如果你需要快速找到页面，可以使用顶部的搜索栏或搜索快捷键（Ctrl+K 或 Cmd+K）。

我们推荐从 [快速开始](https://docs.univer.ai/zh-CN/guides/docs/getting-started/installation.md) 出发了解 Web SDK。

## 前置知识

尽管我们已经尽力使得文档对新手也易于理解，但是我们必须假设你在开始阅读之前已经了解了一些基础知识，以便我们的文档可以专注于 Web SDK。

为了充分利用我们的文档，建议你对 JavaScript 及其生态系统有基本的了解。

如果你有兴趣在 Node.js 上运行 Web SDK，你还应该对 Node.js 有基本的了解。

如果你想尝试高级功能并部署 Univer Server，我们建议你对 Linux、Docker 和 Docker Compose（或 Kubernetes）有基本的了解。

## 扩展 Univer Docs

在设计之初，Web SDK 就被设计为高度可扩展的，因此你可以根据自己的需求来定制它。

- [快速开始](https://docs.univer.ai/zh-CN/guides/docs/getting-started/installation.md)

- [在 Node.js 上运行](https://docs.univer.ai/zh-CN/guides/docs/getting-started/node.md)

- [许可证](https://docs.univer.ai/zh-CN/guides/license.md)

- [功能一览](https://docs.univer.ai/zh-CN/guides/docs/features/core.md)

- [API 参考](https://docs.univer.ai/zh-CN/reference/classes/univer.md)