在优快云文章中创建内部索引(通常指文章目录或章节跳转链接),可以通过以下两种方式实现:
方法一:自动生成目录(推荐)
优快云的Markdown编辑器支持通过 @[TOC]
标签自动生成文章目录,前提是文章已使用规范的标题层级(如 #
, ##
, ###
等)。
步骤:
-
编写标题:使用
#
符号标记文章的标题层级。例如:# 一级标题 ## 二级标题 ### 三级标题
-
插入目录:在文章开头添加
@[TOC]
,发布后会自动生成目录:[TOC]
-
效果:发布文章后,优快云会自动将标题转换为可点击的目录,读者可点击跳转到对应章节。
方法二:手动创建锚点索引
如果需要更灵活的跳转(例如跨段落跳转),可以手动设置锚点链接。
步骤:
-
定义锚点
在目标位置插入<a id="锚点名称"></a>
,例如:<a id="section1">第一</a> 或者<span id="section1">1. 如何克隆远程仓库到本地?</span> ## 第一章 简介
-
创建跳转链接
在目录或正文中添加链接,格式为[显示文字](#锚点名称)
:[跳转到第一章](#section1)
完整示例:
第一章 简介
这里是第一章内容…
第二章 配置方法
这里是第二章内容…
注意事项
-
锚点命名规则:
- 避免特殊字符(如空格、中文),建议用英文和短横线(如
#config-step
)。 - 优快云自动生成的目录锚点通常将标题转换为小写并用短横线分隔空格(例如标题
## 安装步骤
的锚点为#安装步骤
)。
- 避免特殊字符(如空格、中文),建议用英文和短横线(如
-
兼容性:
- 使用
[TOC]
时,确保标题层级正确(至少两个及以上层级的标题)。 - 手动锚点需自行保证唯一性。
- 使用
效果预览
发布文章后,读者点击目录或锚点链接即可快速跳转到对应位置。此方法适用于长文分章节的场景,能显著提升阅读体验。