本指南介绍如何直接链接到 Discourse 帖子或主题中的标题,使用户能够高效地浏览长篇帖子。
所需用户级别:所有用户
在长篇帖子中添加标题可以提高内容的可读性,并允许用户直接链接到特定部分。这对于浏览大量的讨论和文档特别有用。
摘要
本指南涵盖:
- 使用 Markdown 创建标题
- 直接链接到帖子中的特定标题
使用 Markdown 创建标题
要在 Markdown 中创建标题,请在文本行前加上一个或多个 # 字符。# 字符的数量对应于标题级别。以下是一些示例:
## 这是一个二级标题
后面是一小段文字。
### 这是一个三级标题
再后面是一小段文字。
渲染后的效果如下:
这是一个二级标题
后面是一小段文字。
这是一个三级标题
再后面是一小段文字。
直接链接到标题
要共享指向帖子中特定标题的直接链接:
- 悬停在标题上,旁边会出现一个链接图标:
。 - 点击链接图标,浏览器地址栏中的 URL 将更新为指向该标题的直接链接。
- 从地址栏复制更新后的 URL 以与他人共享。
链接图标仅在桌面(非触摸屏)设备上悬停在标题上时才会显示。在触摸屏和移动设备上,锚点链接存在于页面中,但不可见。
了解标题锚点 URL
当您单击标题的链接图标时,地址栏中的 URL 会使用以下格式的片段进行更新:
#p-{postId}-{slugified-heading}-{number}
例如,帖子 12345 中标题为“Getting Started”的链接会生成一个类似 #p-12345-getting-started-1 的 URL 片段。末尾的数字是基于标题在帖子中位置的顺序计数器。
最佳实践
- 使用描述性的标题以清晰地总结内容。
- 在适当的情况下,使用分层标题来组织您的帖子。
- 确保标题一致且合乎逻辑,以提高可读性。
- 请注意,编辑标题文本或更改标题顺序将更改其锚点 URL,这可能会导致现有链接失效。
常见问题解答
我能链接到帖子的任何部分吗?
您可以链接到任何使用 Markdown 正确格式化的标题,只要它不在引用块或引文块内。这些块内的标题不会生成锚点链接。
标题链接在不同的帖子之间有效吗?
是的!当在其他主题中使用或在别处共享时,这些链接会直接指向帖子中的标题。