许多Markdown处理器支持标题的自定义ID - 一些Markdown处理器会自动添加它们。添加自定义ID允许您直接链接到标题并使用CSS对其进行修改。

要添加自定义标题ID,只需要在与标题相同的行上用大括号括起该自定义ID即可。

### My Great Heading {#custom-id}

Markdown解析转为HTML:

<h3 id="custom-id">My Great Heading</h3>

自定义ID规范

如上例所示,自定义id会转化为HTML元素的ID属性。ID属性在HTML文档中必须是唯一的,所以在自定义ID时一定要保证不能重复。

另外ID的命名也需要遵循html中ID属性的命名规范:

  • id命名由字母A-Za-z、数字0-9、连字符-、下划线_、冒号:、点号.组成,且必须以字母开头;
  • id值是大小写敏感的,即testTestTEST是不同的ID;
  • 必须包含至少一个字符;
  • 不能包含任何空格字符。

上面特殊符号中的冒号:和点号.,如果非必须,建议最好不使用。因为在使用脚本获取时必须要进行转义才能正常获取,否则会报错。
id命名不建议使用冒号和点号.jpg

链接到标题ID (#custom-id)

通过创建带有数字符号(#)和自定义标题ID的标准链接,可以链接到文件中具有自定义ID的标题。

Markdown:

[自定义标题ID](#custom-id)

转为HTML:

<a href="#custom-id">自定义标题ID</a>

其他网站可以通过将自定义标题ID添加到网页的完整URL(例如[自定义标题ID](https://xxx/yyy.html#custom-id))来链接到标题。

结语

注意,使用标题自定义ID特性,依然需要去关注Markdown编辑器的兼容性。

一般情况下,我们不需要去关注标题的ID,但当我们需要对标题进行个性化设置时,如果能快速定位到标题ID,这将会让我们的工作事半功倍。