Help us learn about your current experience with the documentation. Take the survey.

Wiki 特定的 Markdown

  • Tier: Free, Premium, Ultimate
  • Offering: GitLab.com, GitLab Self-Managed, GitLab Dedicated

以下主题介绍 wiki 内部链接的行为。

链接到 wiki 页面时,应使用 页面 slug 而不是页面名称。

直接页面链接

直接页面链接包含指向该页面的页面 slug,位于 wiki 的基础层级。

此示例链接到 wiki 根目录下的 documentation 页面:

[Link to Documentation](documentation)

直接文件链接

直接文件链接指向相对于当前页面的文件扩展名。

如果以下示例位于 <your_wiki>/documentation/related 页面上,它会链接到 <your_wiki>/documentation/file.md

[Link to File](file.md)

分层链接

可以通过使用相对路径(如 ./<page>../<page>)相对于当前 wiki 页面构建分层链接。

如果此示例位于 <your_wiki>/documentation/main 页面上,它会链接到 <your_wiki>/documentation/related

[Link to Related Page](related)

如果此示例位于 <your_wiki>/documentation/related/content 页面上,它会链接到 <your_wiki>/documentation/main

[Link to Related Page](../main)

如果此示例位于 <your_wiki>/documentation/main 页面上,它会链接到 <your_wiki>/documentation/related.md

[Link to Related Page](related.md)

如果此示例位于 <your_wiki>/documentation/related/content 页面上,它会链接到 <your_wiki>/documentation/main.md

[Link to Related Page](../main.md)

根链接

根链接以 / 开头,相对于 wiki 根目录。

此示例链接到 <wiki_root>/documentation

[Link to Related Page](/documentation)

此示例链接到 <wiki_root>/documentation.md

[Link to Related Page](/documentation.md)

diagrams.net 编辑器

在 wikis 中,你可以使用 diagrams.net 编辑器创建图表。你也可以编辑使用 diagrams.net 编辑器创建的图表。图表编辑器在纯文本编辑器和富文本编辑器中都可用。

更多信息,请参阅 Diagrams.net

纯文本编辑器

要在纯文本编辑器中创建图表:

  1. 在要编辑的 wiki 页面上,选择 编辑
  2. 在文本框中,确保你使用的是纯文本编辑器(左下角的按钮显示 切换到富文本编辑)。
  3. 在编辑器的工具栏中,选择 插入或编辑图表 diagram )。
  4. app.diagrams.net 编辑器中创建图表。
  5. 选择 保存并退出

会在 wiki 内容中插入一个指向该图表的 Markdown 图片引用。

要在纯文本编辑器中编辑图表:

  1. 在要编辑的 wiki 页面上,选择 编辑
  2. 在文本框中,确保你使用的是纯文本编辑器(左下角的按钮显示 切换到富文本编辑)。
  3. 将光标定位在包含图表的 Markdown 图片引用中。
  4. 选择 插入或编辑图表 diagram )。
  5. app.diagrams.net 编辑器中编辑图表。
  6. 选择 保存并退出

会在 wiki 内容中插入一个指向该图表的 Markdown 图片引用,替换之前的图表。

富文本编辑器

要在富文本编辑器中创建图表:

  1. 在要编辑的 wiki 页面上,选择 编辑
  2. 在文本框中,确保你使用的是富文本编辑器(左下角的按钮显示 切换到纯文本编辑)。
  3. 在编辑器的工具栏中,选择 更多选项 plus )。
  4. 在下拉列表中,选择 创建或编辑图表
  5. app.diagrams.net 编辑器中创建图表。
  6. 选择 保存并退出

在 diagrams.net 编辑器中可视化的图表会被插入到 wiki 内容中。

要在富文本编辑器中编辑图表:

  1. 在要编辑的 wiki 页面上,选择 编辑
  2. 在文本框中,确保你使用的是富文本编辑器(左下角的按钮显示 切换到纯文本编辑)。
  3. 选择要编辑的图表。
  4. 在浮动工具栏中,选择 编辑图表 diagram )。
  5. app.diagrams.net 编辑器中编辑图表。
  6. 选择 保存并退出

所选图表会被更新后的版本替换。