- 点击导航元素以展开或折叠。
- 点击页面将在编辑器中打开它。
- 点击搜索 icon，或按下 Cmd + K (macOS) 或 Ctrl + K (Windows) ，搜索文件和内容。搜索会在文件名和页面内容中查找匹配项。
- 点击工具栏中的隐藏侧边栏按钮以折叠侧边栏，为编辑器留出更多空间。
导航标签页按页面标题列出页面。文件标签页按页面的文件名和扩展名列出页面。
创建新页面
- 在要添加页面的导航区域中，点击 按钮。
- 点击 Add a page。
- 输入文件名，编辑器会自动添加
.mdx扩展名。
编辑内容
可视模式
- 添加文本：在编辑器中输入，查看文本在发布后如何呈现。
- 格式化文本：使用工具栏将文本加粗、设置为斜体或应用其他格式。
- 添加组件：按下 / 打开组件菜单并选择组件。
- 添加图片：从 / 菜单中使用 image 组件，或输入 /image。
- 添加视频：输入 /video 来上传或选择视频。
- 添加嵌入内容：输入 /embed 来插入 YouTube、Loom 或自定义 HTML 的嵌入内容。详情参见 Add media。
- 添加 Mermaid 图表：输入 /mermaid 来插入带有交互式预览、缩放/平移控件和代码编辑器的 Mermaid 图表。
- 添加片段：输入 /snippet 来搜索并插入可复用片段。编辑器会自动添加所需的 import 语句。
- 添加数学公式：输入 /inline-math 以插入行内 LaTeX 公式，或输入 /block-math 以插入居中的块级公式。请先在站点设置中启用 LaTeX。
- 添加 Prompt 块：输入 /prompt 来插入带有复制操作的 AI Prompt 模板。
- 编辑表格：当光标位于表格内部时，使用浮动工具栏添加或删除行和列，或合并单元格。
- 插入链接：选中文本并按 Cmd + K，或将页面从导航树中拖入编辑器，以使用该页面标题创建链接。
Markdown 模式
- 直接编辑 MDX：编写 MDX 和 Markdown 语法，以精确控制内容。
- 组件属性：设置组件属性和配置。
- Frontmatter：编辑文件顶部的页面元数据。
配置页面
- 标题：设置主标题。会显示在导航、浏览器标签页和搜索结果中。
- Slug：设置页面的 URL 路径。slug 默认是相对于存储库根目录且不包含文件扩展名的路径。例如，
guides/getting-started.mdx会变为guides/getting-started。更改 slug 会重命名并移动文件，以匹配新路径。 - 侧边栏标题：当完整标题在侧边栏中过长时，可以在导航中显示更短的文本。
- Icon：在页面旁边添加视觉标记，帮助用户快速识别。
- 外部 URL：链接到外部站点，而不是某个页面。使用此选项将外部资源添加到你的导航中。
为搜索和分享进行优化
- Description：撰写简短摘要。会显示在搜索结果和 SEO (搜索引擎优化) 元标签中。
- Keywords：添加相关搜索词，帮助用户更容易发现此页面。
- OG Image URL：为社交媒体分享和链接预览设置自定义预览图片。
控制页面布局
- 标准布局 (
default) ：带有侧边栏导航和目录的默认页面。 - 全宽布局 (
wide) ：隐藏目录，为表格、图表或其他内容提供更宽的布局。 - 居中布局 (
center) ：隐藏侧边栏和目录，以提升更新日志等文本较多页面的可读性。 - 自定义宽度 (
custom) ：仅保留顶部导航栏的极简布局，适用于着陆页或其他特殊布局。
管理页面
移动页面
重命名页面
复制页面
删除页面
隐藏页面
docs.json 的导航中。