链接到帖子或主题中的标题

:bookmark: 本指南介绍如何直接链接到 Discourse 帖子或主题中的标题,使用户能够高效地浏览长篇帖子。

:person_raising_hand: 所需用户级别:所有用户

在长篇帖子中添加标题可以提高内容的可读性,并允许用户直接链接到特定部分。这对于浏览大量的讨论和文档特别有用。

摘要

本指南涵盖:

  • 使用 Markdown 创建标题
  • 直接链接到帖子中的特定标题

使用 Markdown 创建标题

要在 Markdown 中创建标题,请在文本行前加上一个或多个 # 字符。# 字符的数量对应于标题级别。以下是一些示例:

## 这是一个二级标题
后面是一小段文字。

### 这是一个三级标题
再后面是一小段文字。

渲染后的效果如下:


这是一个二级标题

后面是一小段文字。

这是一个三级标题

再后面是一小段文字。


直接链接到标题

要共享指向帖子中特定标题的直接链接:

  1. 悬停在标题上,旁边会出现一个链接图标:link icon
  2. 点击链接图标,浏览器地址栏中的 URL 将更新为指向该标题的直接链接。
  3. 从地址栏复制更新后的 URL 以与他人共享。

:information_source: 链接图标仅在桌面(非触摸屏)设备上悬停在标题上时才会显示。在触摸屏和移动设备上,锚点链接存在于页面中,但不可见。

了解标题锚点 URL

当您单击标题的链接图标时,地址栏中的 URL 会使用以下格式的片段进行更新:

#p-{postId}-{slugified-heading}-{number}

例如,帖子 12345 中标题为“Getting Started”的链接会生成一个类似 #p-12345-getting-started-1 的 URL 片段。末尾的数字是基于标题在帖子中位置的顺序计数器。

最佳实践

  • 使用描述性的标题以清晰地总结内容。
  • 在适当的情况下,使用分层标题来组织您的帖子。
  • 确保标题一致且合乎逻辑,以提高可读性。
  • 请注意,编辑标题文本或更改标题顺序将更改其锚点 URL,这可能会导致现有链接失效。

常见问题解答

我能链接到帖子的任何部分吗?
您可以链接到任何使用 Markdown 正确格式化的标题,只要它不在引用块或引文块内。这些块内的标题不会生成锚点链接。

标题链接在不同的帖子之间有效吗?
是的!当在其他主题中使用或在别处共享时,这些链接会直接指向帖子中的标题。

附加资源

73 个赞