MarkDown中实现目录页面内跳转

白色玫瑰 程序猿

时间: 2023-07-11 阅读: 1 字数:9893

{}
MarkDown中页面内跳转经常用于目录跳转,为了解决在MarkDown中实现页面内跳转,我特意研究了以下实现方式; 备注: 简书中的MarkDown好像不支持页面内跳转; 目录 一. 链接的定义 1. 行内式链接 2. 参考式...

MarkDown中页面内跳转经常用于目录跳转,为了解决在MarkDown中实现页面内跳转,我特意研究了以下实现方式;

在MarkDown中,页面内跳转的方法中最重要的是:要按住ctrl去访问,才能页面内跳转!!!!

目录

一. 链接的定义
   1. 行内式链接
   2. 参考式链接
二. 标题的定义
   1. 类Setex形式的标题
   2. 类Atx形式的标题
三. 页面内跳转
   1. 锚点的定义
   2. 锚点目标的定义
四. 总结
五. 示例

内容

<hr>

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

一. 链接的定义

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

1. 行内式链接

语法:

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

说明:

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

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

<a href="地址" title="标题">内容</a>

示例:

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

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

<a href="https://www.jianshu.com/u/7ecaba2d594c" title="郭斌勇的主页">我的博客</a>

效果如下:

<a href="https://www.jianshu.com/u/7ecaba2d594c" title="我的博客">我的博客</a>

2. 参考式链接

语法:

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

说明:

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

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

<a href="地址" title="标题">内容</a>

示例:

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

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

<a href="https://www.jianshu.com/u/7ecaba2d594c" title="郭斌勇的主页">我的博客</a>
<a href="https://www.jianshu.com/u/7ecaba2d594c" title="郭斌勇的主页">博客</a>

效果如下:

<a href="https://www.jianshu.com/u/7ecaba2d594c" title="我的博客">我的博客</a> <a href="https://www.jianshu.com/u/7ecaba2d594c" title="博客">博客</a>

二. 标题的定义

Markdown 支持两种标题的语法:类Setext形式 和 类atx形式;

1. 类Setex形式的标题

类Setext形式标题的定义是用底线的形式,可以利用任何个数的符号 =(最高级标题)和 -(第2级标题)来做底线,格式为:

标题内容
====

标题内容
----

说明:

底线的符号个数为大于或等于1

示例:

这是一级标题
====

这是二级标题
----

效果如下:

这是一级标题

这是二级标题

2. 类Atx形式的标题

类 Atx 形式标题的定义则是在行首插入 1 到 6 个 # ,对应到标题 1 到 6 阶,格式为:

# 1级标题内容
## 2级标题内容
### 3级标题内容
#### 4级标题内容
##### 5级标题内容
###### 6级标题内容

示例:

# 这是1级标题
## 这是2级标题
### 这是3级标题
#### 这是4级标题
##### 这是5级标题
###### 这是6级标题

效果如下:

这是1级标题

这是2级标题

这是3级标题

这是4级标题

这是5级标题

这是6级标题

三. 页面内跳转

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

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

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

1. 锚点的定义

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

1.1 MarkDown锚点

MarkDown锚点本质上就是一个<a href="#%E9%93%BE%E6%8E%A5%E7%9A%84%E5%AE%9A%E4%B9%89">MarkDown链接</a>,只是链接地址的格式为:

链接地址 = #目标内容

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

行内式

语法:

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

说明:

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

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

<a href="#目标内容" title="标题">内容</a>

示例:

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

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

<a href="#MarkDown锚点" >MarkDown方式的锚点</a>

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

<a href="#MarkDown%E9%94%9A%E7%82%B9">MarkDown方式的锚点</a>

参考式

语法:

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

说明:

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

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

<a href="#目标内容" title="标题">内容</a>

示例:

[MarkDown方式的锚点]: #MarkDown锚点
[MD锚点][MarkDown方式的锚点]
[MarkDown方式的锚点][]

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

<a href="#MarkDown锚点">MD锚点</a>
<a href="#MarkDown锚点">MarkDown方式的锚点</a>

效果如下:

<a href="#MarkDown%E9%94%9A%E7%82%B9">MD锚点</a>

<a href="#MarkDown%E9%94%9A%E7%82%B9">MarkDown方式的锚点</a>

1.2 HTML锚点

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

<a href="#目标内容">内容</a>

注意:

HTML锚点 的目标锚点只能是 <a href="#%E6%A0%87%E7%AD%BE%E5%BD%A2%E5%BC%8F%E7%9A%84%E9%94%9A%E7%82%B9%E7%9B%AE%E6%A0%87">标签形式的锚点目标</a>

示例:

<a href="#html锚点">HTML方式的锚点</a>

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

<a href="#html锚点">HTML方式的锚点</a>

2. 锚点目标的定义

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

MarkDown形式的锚点目标

MarkDown形式的锚点目标的定义其实就是<a href="#MarkDowm%E5%AE%9E%E7%8E%B0%E9%A1%B5%E9%9D%A2%E5%86%85%E8%B7%B3%E8%BD%AC%E7%9A%84%E6%96%B9%E5%BC%8F">标题</a>的定义,即:任何级别的标题可以直接作为锚点目标;

标题内容 = 目标内容

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

锚点目标定义的示例:

这是一个锚点目标
====

这是一个锚点目标
---

# 这是一个锚点目标
## 这是一个锚点目标
### 这是一个锚点目标
#### 这是一个锚点目标
##### 这是一个锚点目标
###### 这是一个锚点目标

注意:

<a href="#%E9%94%9A%E7%82%B9%E7%9A%84%E5%AE%9A%E4%B9%89">锚点</a>的 目标内容 中不能有大家字母和空格,所以如果锚点目标的 目标内容 中有大写字母或空格,则需要在定义锚点中的 目标内容 时,把大写字母改成小写字母,把空格改成 -; <a href="#%E9%94%9A%E7%82%B9%E7%9A%84%E5%AE%9A%E4%B9%89">锚点</a>的 目标内容 中不能含有以下字符:

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

标签形式的锚点目标

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

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

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

<a name="目标内容">元素内容</a>

注意:

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

示例:

<div id="这是锚点目标">跳转到这里</div>

<a name="这是锚点目标">跳转到这里</a>

四. 总结

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

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

说明:

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

注意:

<a href="#%E9%94%9A%E7%82%B9%E7%9A%84%E5%AE%9A%E4%B9%89">锚点</a>的 目标内容 中不能有大家字母和空格,所以如果锚点目标的 目标内容 中有大写字母或空格,则需要在定义锚点中的 目标内容 时,把大写字母改成小写字母,把空格改成 -; <a href="#%E9%94%9A%E7%82%B9%E7%9A%84%E5%AE%9A%E4%B9%89">锚点</a>的 目标内容 中不能含有以下字符:

半角点(即英文中的句号). 标签形式的锚点目标的id特性值中是不能含有中文字符; name 特性只能应用在 a 标签上; HTML5不支持通过a标签的 name 特性来定义锚点目标; HTML锚点 的目标锚点只能是 <a href="#%E6%A0%87%E7%AD%BE%E5%BD%A2%E5%BC%8F%E7%9A%84%E9%94%9A%E7%82%B9%E7%9B%AE%E6%A0%87">标签形式的锚点目标</a>

五. 示例

示例1

锚点:

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

锚点目标:

# 个人简介

示例2

锚点:

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

锚点目标:

个人简介
=====

示例3

锚点:

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

锚点目标:


这是个人简介

示例4

锚点:

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

锚点目标:

<a name="个人简介">这是个人简介</a>

示例5

锚点:

<a href="#个人简介">跳转到个人简介</a>

锚点目标:

个人简介
----

示例6

锚点:

<a href="#个人简介">跳转到个人简介</a>

锚点目标:


# 这是个人简介

示例7

锚点:

<a href="#个人简介">跳转到个人简介</a>

锚点目标:

<a name="个人简介">这是个人简介</a>

转载<a href="https://www.jianshu.com/p/4898c2e9a36d" title="https://www.jianshu.com/p/4898c2e9a36d">https://www.jianshu.com/p/4898c2e9a36d</a>

原文地址:https://blog.csdn.net/weixin_50464560/article/details/114784012?ops_request_misc=%257B%2522request%255Fid%2522%253A%2522168906542916800213021592%2522%252C%2522scm%2522%253A%252220140713.130102334.pc%255Fall.%2522%257D&request_id=168906542916800213021592&biz_id=0&utm_medium=distribute.pc_search_result.none-task-blog-2~all~first_rank_ecpm_v1~rank_v31_ecpm-10-114784012-null-null.142^v88^control_2,239^v2^insert_chatgpt&utm_term=markdown

本文章网址:https://www.sjxi.cn/detil/24103859b75449799b4abc7807a36cc7

最新评论

当前未登陆哦
登陆后才可评论哦

湘ICP备2021009447号