文章内跳转
发布日期:2021-07-01 02:40:09 浏览次数:2 分类:技术文章

本文共 3118 字,大约阅读时间需要 10 分钟。

1 2 3 4 5
1. 跳转起点 [点击我跳转](#jump) 2.跳转终点 [我是跳转内容]

[我是跳转内容]

参考文章:

内容


在MarkDown中是通过 链接标题 来实现页面内跳转的,所以先讲下MarkDown中 链接标题 的语法,然后再讲 MarkDown 中实现页面内跳转的方法;

一. 链接的定义

Markdown 支持两种形式的链接语法: 行内式 和 参考式 两种形式。

1. 行内式链接

语法:

1
行内式链接 = [内容](地址 "标题")

说明:

  • 标题 是可选的,可以用单引号 或 双引号;

转换成HTML后,会生成如下标签:

1
内容

示例:

1
[我的博客](https://www.jianshu.com/u/7ecaba2d594c "郭斌勇的主页")

渲染成HTML后,会生成如下标签:

1
我的博客

效果如下:

2. 参考式链接

语法:

1 2
参考式链接 = [内容][参考标识符] 参考标识符 = [标识符]: 地址 "标题"

说明:

  • 参考式链接参考标识符 的定义没有先后顺序;
  • [内容][参考标识符] 之间可以有一个空格,也可以没有空格;
  • 如果 内容参考标识符 一样,也可简写成 [参考标识符][] ;
  • 标题 是可选的,可以用单引号、双引号或是圆括弧包着;

转换成HTML后,会生成如下标签:

1
内容

示例:

1 2 3
[博客]: https://www.jianshu.com/u/7ecaba2d594c "郭斌勇的主页" [我的博客][博客] [博客][]

渲染成HTML后,会生成如下标签:

1 2
我的博客 博客

效果如下:

三.页面内跳转

MarkDown中是通过定义链接的方式来定义跳转的,在这里,跳转也称为锚点,跳转的目标称为锚点目标

所以,在 MarkDown 中实现页面内跳转的方法就是:定义一个 锚点目标 和 对应的 锚点 ,用户点击 锚点 便可跳转到对应的 锚点目标 位置处;

锚点锚点目标 的定义格式如下:

1. 锚点的定义

锚点就是一个链接,另外,由于在MarkDown中可以直接写HTML,所以在MarkDown中实现锚点有两种方式:MarkDown方式 和 HTML方式;

1.1 MarkDown锚点

MarkDown锚点本质上就是一个,只是链接地址的格式为:

1
链接地址 = #目标内容

所以 MarkDown锚点 的定义也有两种方式

行内式

语法:

1
锚点 = [内容](#目标内容 "标题")

说明:

  • 标题 是可选的,可以用单引号 或 双引号;

转换成HTML后,会生成如下标签:

1
内容

示例:

1
[MarkDown方式的锚点](#MarkDown锚点)

渲染成HTML后,会生成如下标签:

1
MarkDown方式的锚点

效果如下:点击下面的锚点

参考式

语法:

1 2
锚点 = [内容][参考标识符] 参考标识符 = [标识符]: #目标内容 "标题"

说明:

  • 锚点参考标识符 的定义没有先后顺序;
  • [内容][参考标识符] 之间可以有一个空格,也可以没有空格;
  • 如果 内容参考标识符 一样,也可简写成 [参考标识符][] ;
  • 标题 是可选的,可以用单引号、双引号或是圆括弧包着;

转换成HTML后,会生成如下标签:

1
内容

示例:

1 2 3
[MarkDown方式的锚点]: #MarkDown锚点 [MD锚点][MarkDown方式的锚点] [MarkDown方式的锚点][]

渲染成HTML后,会生成如下标签:

1 2
MD锚点 MarkDown方式的锚点

效果如下:

1.2 HTML锚点

HTML锚点本质上就是一个a链接,格式为:

1
内容

注意:

  • HTML锚点 的目标锚点只能是

示例:

1
HTML方式的锚点

效果如下:点击下面的锚点

2. 锚点目标的定义

锚点目标有2种定义方式:MarkDown形式 和 标签形式;

MarkDown形式的锚点目标

MarkDown形式的锚点目标的定义其实就是的定义,即:任何级别的标题可以直接作为锚点目标;

1
标题内容 = 目标内容

所以,类Setext形式 和 类atx形式 的标题都可作为 锚点目标

锚点目标定义的示例:

1 2 3 4 5 6 7 8 9 10 11 12
这是一个锚点目标 ==== 这是一个锚点目标 --- # 这是一个锚点目标 ## 这是一个锚点目标 ### 这是一个锚点目标 #### 这是一个锚点目标 ##### 这是一个锚点目标 ###### 这是一个锚点目标

注意:

  • 目标内容 中不能有大家字母和空格,所以如果锚点目标的 目标内容 中有大写字母或空格,则需要在定义锚点中的 目标内容 时,把大写字母改成小写字母,把空格改成 -

  • 锚点

    1
    目标内容

    中不能含有以下字符:

    • 半角点(即英文中的句号).

标签形式的锚点目标

因为MarkDown链接会被转成a标签,并且MarkDown中也可以写标签,所以可以利用HTML的锚点机制直接定义一个带 id 特性的任意标签 或 带 name 特性的 a 标签(注意:在HTML5中,a标签已经不再支持 name 特性)作为锚点目标,然后把MarkDown中的锚点地址的目标内容设置为 idname 特性的值;这样便可以实现页面内跳转;

这种形式的锚点目标的定义格式为:

1
<标签名 id="目标内容">
元素内容

1
元素内容

注意:

  • 标签形式的锚点目标的id特性值中是不能含有中文字符;
  • name 特性只能应用在 a 标签上;
  • HTML5不支持通过a标签的 name 特性来定义锚点目标;

示例:

1
跳转到这里

1
跳转到这里

四. 总结

MarkDown中实现页面跳转的方法如下:

  1. 定义锚点目标;锚点目标的定义方式有4种:类Setext形式的标题、类atx形式的标题、带id特性的HTML标签(id特性的值为目标内容)、带name特性的a标签(name特性的值为目标内容);
  2. 定义锚点;锚点的定义方式有3种:行内式链接、参考式链接、HTML的a链接;

说明:

  • 锚点 和 锚点目标 的定义不分先后顺序;

注意:

  • 目标内容 中不能有大家字母和空格,所以如果锚点目标的 目标内容 中有大写字母或空格,则需要在定义锚点中的 目标内容 时,把大写字母改成小写字母,把空格改成 -

  • 锚点

    1
    目标内容

    中不能含有以下字符:

    • 半角点(即英文中的句号).
  • 标签形式的锚点目标的id特性值中是不能含有中文字符;

  • name 特性只能应用在 a 标签上;

  • HTML5不支持通过a标签的 name 特性来定义锚点目标;

  • HTML锚点 的目标锚点只能是

五. 示例

示例1

锚点:

1
[跳转到个人简介](#个人简介)

锚点目标:

1
# 个人简介

示例2

锚点:

1 2
[跳转到个人简介]: #个人简介 [跳转到个人简介][]

锚点目标:

1 2
个人简介 =====

示例3

锚点:

1
[跳转到个人简介](#个人简介)

锚点目标:

1

这是个人简介

示例4

锚点:

1
[跳转到个人简介](#个人简介)

锚点目标:

1
这是个人简介

示例5

锚点:

1
跳转到个人简介

锚点目标:

1 2
个人简介 ----

示例6

锚点:

1
跳转到个人简介

锚点目标:

1

这是个人简介

示例7

锚点:

1
跳转到个人简介

锚点目标:

1
这是个人简介

转载地址:https://melodyjerry.blog.csdn.net/article/details/106617385 如侵犯您的版权,请留言回复原文章的地址,我们会给您删除此文章,给您带来不便请您谅解!

上一篇:IDEA启动Tomcat报错
下一篇:[转]jsdelivr的使用

发表评论

最新留言

很好
[***.229.124.182]2024年05月03日 08时33分00秒

关于作者

    喝酒易醉,品茶养心,人生如梦,品茶悟道,何以解忧?唯有杜康!
-- 愿君每日到此一游!

推荐文章