撰写文章并整理集合

Shayan Taslim更新

帮助中心会将文章整理在各个集合中,并为团队提供富文本编辑器,支持内部链接、修订历史和可见性控制。

整理集合

在控制面板侧边栏中,打开 帮助中心 → 文章,管理导航树。

  • 创建集合。点击顶部栏中的 新建集合,输入名称(最多 255 个字符;输入时,UserJot 会自动推荐图标,直到你手动选择图标),选择图标,然后点击创建。新集合会显示在顶层列表的底部。

  • 编辑集合。 右键点击集合并选择编辑…,即可更新图标、名称或说明(最多 500 个字符)。

  • 嵌套和重新排序。 在树状列表中拖放集合和文章即可重新排序或嵌套,也可以右键点击并选择移动到。集合最多可嵌套三层。

  • 顶层文章和未放置的文章。 放在顶层的文章会显示在所有集合之外,并且可以设置自定义图标(右键点击 → 更改图标…)。点击顶部栏中的新建文章,会在无集合下创建一篇未放置的草稿。未放置的文章不会显示在列表中,也无法搜索到,除非将其放到顶层或某个集合中。

  • 删除集合。 右键点击集合并选择删除…。集合删除后无法恢复,也不会先移入回收站。如果集合中有文章,请选择将其移至其他集合、顶层或无集合(将文章移至其他集合后,原集合的旧 URL 会重定向到该集合)。

使用编辑器撰写内容

每篇文章都必须填写标题(最多 255 个字符),可以选择填写说明(最多 500 个字符,用于卡片和元描述),并使用正文编辑器撰写内容。

在新行按 / 可插入以下内容块:

  • 文本、标题(H2)和副标题(H3)。标题会自动生成稳定的章节锚点。

  • 项目符号列表、编号列表、引用、代码块(可选择语言)和分隔线。

  • 图片(从电脑上传文件;点击图片可添加替代文本或说明文字,每项最多 500 个字符)。

  • 表格(默认插入 3×3 表格,带标题行和浮动的行/列控件)。

  • 备注、提示和警告提示框,以及可折叠的 手风琴块(标题为 1 到 200 个字符)。在控制面板编辑器中,提示框和手风琴块不能相互嵌套(通过 API 或导入 HTML 时,提示框可以出现在手风琴块中;但不允许提示框嵌套提示框、手风琴块嵌套提示框,或手风琴块嵌套手风琴块)。

  • 嵌入来自 YouTube、Loom 或 Vimeo 的视频(也可以单独在一行粘贴这些平台的链接)。

选中文本即可应用粗体、斜体、删除线、代码、按键(键盘快捷键样式)或链接。代码和按键不能与其他行内格式标记组合使用,并且 按键文本中不能包含 < 或 >。文档最多支持 1 MB JSON、512 KB Markdown、5,000 个节点和 32 层块嵌套。

草稿会在你输入时自动保存。按 ⌘S / Ctrl+S 手动保存,按 ⌘⇧\ / Ctrl+Shift+\ 显示或隐藏文章列表侧栏,点击右下角的 预览 切换读者视图,或点击左下角的打字音效控件,选择可选的机械键盘音效(羊驼、奶油、薄荷、麻糬、霜冻或关闭),并通过音量滑块调节音量。

帮助中心 Markdown 方言

REST API、MCP 服务器、复制页面和 .md 端点使用 GitHub 风格的 Markdown,并扩展支持以下内容:

  • <Note>、<Tip>和<Warning>提示框块

  • <Accordion title="...">可折叠区域

  • 在标题末尾添加 {#custom-id},以锁定稳定的锚点

  • <kbd>...</kbd>用于行内键盘按键

  • 写作 /articles/<slug> 或 /collections/<slug> 的内部链接(可选添加 #heading)

点击选区工具栏中的链接按钮,打开添加链接。搜索帮助中心中的文章、集合和已发布文章的标题(搜索标题至少需要 2 个字符,最多返回 8 条匹配结果),或粘贴外部 https:// URL。粘贴指向你自己的帮助文章的 URL 时,该链接会转换为内部引用,即使目标文章的 slug 发生变化,链接仍会有效。

如果链接目标之后被取消发布、移入回收站或删除,编辑器会在正文中突出显示该链接,方便你进行修复。右侧文章栏中的链接自列表会显示最多八篇链接到当前文章的已发布文章。

打开右侧的文章栏,配置读者查找文章的方式:

设置

作用

可见性

选择公开(会列出、可搜索,并包含在 llms.txt 和 Juno 中)、不公开列出(只能通过直接链接访问;不会显示在导航和搜索中,也不会包含在 Juno 中),或团队(仅限已登录的内部管理员和所有者)。

集合

将文章放在顶层、某个集合中,或保留在无集合中。

链接

点击 /help/articles/<slug> 打开更改链接(仅限小写字母、数字和连字符,最多 60 个字符)。首次发布之前,slug 会随标题变化,直到你手动编辑为止。发布后更改 slug 时,系统会自动将旧 URL 重定向到新 URL。

在搜索引擎中显示

允许或禁止搜索引擎为此文章编入索引。要编入索引,文章还必须设为公开、已放入集合,并且帮助中心已设置为上线。

关键词

为当前语言添加隐藏的搜索关键词(最多 50 个关键词,每个最多 64 个字符)。按 Enter 或逗号即可添加关键词。

你也可以在右侧栏顶部的状态卡片中指定作者(或选择无作者)。

发布、历史记录和回收站

  • 发布。 点击发布(或发布更改,快捷键 ⌘↵)。发布前,弹出窗口会提示缺少图片替代文本或存在失效的内部链接。更新已发布文章时,如果只是修复小的拼写错误,请关闭显示为已更新,这样公开页面上的更新日期就不会改变。

  • 取消发布。 打开更多操作(⋮)→ 取消发布,即可将当前语言版本下线,同时保留其草稿和修订历史。

  • 修订历史。在右侧栏的历史记录下选择任意条目,以只读方式查看(按 Esc 退出预览),然后点击恢复此版本,将其复制回草稿(在点击发布更改之前,该版本仍不会发布)。

  • 比较译文。 编辑已翻译的文章时,在顶部栏中切换比较(在宽屏上可用),即可并排查看已发布的原文,并高亮显示已更改、新增和删除的内容块。

  • 移入回收站并恢复。 打开更多操作(⋮)→ 移入回收站,即可立即移除文章。移入回收站的文章可在 30 天内恢复(其 slug 和重定向会保留),之后将被永久删除。打开回收站中的文章时,会显示从回收站恢复按钮。

后续步骤

这是否解答了您的问题?