奥宏文档
欢迎
API 与集成
MCP 接入指南
MCP 工具详解
MCP 最佳实践
API Token 管理
文档嵌入组件(uldoc-help.js)
快速开始
页面和内容块
创建第一个项目
发布和分享
项目管理
导入导出
项目设置
项目可见性
项目转移
内容编辑
代码块
Markdown 编辑
流程图(BPMN)
脑图
图片管理
HTML 块
iframe 嵌入
版本管理
创建版本
版本切换
多语言
配置语言
多语言编辑
成员协作
转让所有权
角色说明
添加和管理成员
Base Permission(组织项目继承)
组织管理
创建组织
组织项目
组织成员
默认项目权限
付费阅读
付费项目设置
读者管理
阅读权限控制
常见问题
页面树与内容块
奥宏文档的内容由两层结构组成:页面树负责组织目录,内容块负责承载具体内容。
页面树
一个项目的所有页面组成一棵树,支持多级嵌套。你可以这样管理它:
- 在编辑器左侧的目录区,点「+」添加子页面或同级页面
- 按住页面名称拖拽,可以调整层级和排序
- 把一个页面拖到另一个页面下方,它就成了对方的子页面
- 页面可以设为「分组」,分组只作为目录节点,不渲染正文
每个页面也有自己的 UID,它决定这个页面在阅读链接里的地址。
六种内容块
页面内部由若干个内容块从上到下排列,你可以在以下六种类型里挑选:
| 类型 | 适合写什么 |
|---|---|
| Markdown | 普通图文内容,最常用 |
| 代码 | 带语法高亮的代码段,支持文件下载 |
| 脑图 | 思维导图,梳理知识结构 |
| BPMN 流程图 | 业务流程、工作流图 |
| HTML | 自定义网页内容,灵活度最高 |
| iframe | 嵌入第三方页面或在线工具 |
如何添加内容块
- 打开某个页面
- 在已有内容块之间或最下方,点「+ 添加内容块」
- 选择块类型,输入内容
- 保存后内容块立即生效
内容块之间可以拖拽调换顺序,也可以单独为某个块设置语言版本。
分组页面
如果某个页面只想当目录分类用,不写正文,可以在页面设置里勾选「作为分组」。分组页面在阅读视图里只展示它的子页面,自己不渲染内容块。适合用来给一大堆子页面做归类。
页面 UID 与阅读链接
页面的 UID 直接拼在阅读链接里。比如页面 UID 是 getting-started,那它的链接大概长这样:
/read/username/project-uid/getting-started/zh-cn/1.html
给页面起一个有意义的 UID,链接更好记,也方便分享给别人。
原文标题:页面和内容块
原文文档:奥宏文档
原文地址:/read/augushong/ulthon-document/zh-cn/1.0.0/quick-start/pages-and-blocks.html
原文平台:奥宏文档
1.0.0