markdown页内跳转和目录生成
Posted
tags:
篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了markdown页内跳转和目录生成相关的知识,希望对你有一定的参考价值。
参考技术A markdown语法简单好用又容易上手,本人是markdown的铁粉。这篇文章记录markdown的页内跳转语法以及使用doctoc生成目录。不过尴尬的是不支持页内跳转(手动呕吐)。
格式: [显示的标题](#目标目录的标题) ,其中 目标目录标题 中有 空格 时用 - 替换 空格 。
举个栗子:[点击这里进行页面跳转](#使用doctoc生成目录)
显示为: 点击这里进行页面跳转
当文章内容比较多,篇幅过长的时候,我们会想在文章的开头加上目录,使阅读者能清晰的看到整篇文章的结构。除了手动添加之外,我们可以添加一个全局的工具 doctoc ,在需要时,执行一行命令就可以为我们生成目录。
使用如下命令全局安装 doctoc :
如果Mac电脑上因为没有权限而报错,如下:
可以在命令前加上 sudo ,如下:
根据提示输入密码之后,就可以完成安装了。
生成目录的命令如下:
执行成功之后,就会看到目录已经生成在文章的最顶端了。如果需要调整位置,可以手动进行调整。
如果目录有变更,可以使用生成目录的命令进行重新生成。也可以使用更新命令进行目录更新,命令如下:
执行成功之后,目录就会被原地更新。
MarkDown实现页内跳转
前言
在markdown中使用目录,如果能实现页内跳转,那就太棒了。查阅了资料,找到了两种方法,记录如下。
Hello World
实现方法
1、MarkDown 实现
直接上手。
step 1: 生成目录
* [1. 单反入门](#1)
* [1.1 对焦](#1.1)
* [1.2 曝光](#1.2)
* [1.3 光圈](#1.3)
效果:
step 2 跳转到对于章节
只要将章节标题的
id
加上去就可以了。
如下:
<h2 id='1'>1. 单反入门</h2>
熟练掌握摄影三要素:对焦、曝光、光圈。
<h2 id='1.1'>1.1 对焦</h2>
对焦决定你的相片的清晰度。
<h2 id='1.2'>1.2 曝光</h2>
不同的曝光会让照片呈现不一样的效果。
<h2 id='1.3'>1.3 光圈</h2>
大光圈能虚化背景,给人一种层次感。
效果:
1. 单反入门
熟练掌握摄影三要素:对焦、曝光、光圈。
1.1 对焦
对焦决定你的相片的清晰度。
1.2 曝光
不同的曝光会让照片呈现不一样的效果。
1.3 光圈
大光圈能虚化背景,给人一种层次感。
2、加入html 标签
先定义一个锚(id)
<span id="jump">Hello World</span>
然后使用markdown的语法:
[跳到Hello World](#jump)
效果:
<span id="jump">Hello World</span>
这一句放到开头
这是第一段
这是第一段
这是第一段
这是第一段
这是第一段
看不如做,赶紧去试试吧!
以上是关于markdown页内跳转和目录生成的主要内容,如果未能解决你的问题,请参考以下文章