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 标签

  1. 先定义一个锚(id)

     <span id="jump">Hello World</span>
    
  2. 然后使用markdown的语法:

        [跳到Hello World](#jump)
    

效果:

<span id="jump">Hello World</span>

这一句放到开头

这是第一段

这是第一段

这是第一段

这是第一段

这是第一段

跳到Hello World


看不如做,赶紧去试试吧!

以上是关于markdown页内跳转和目录生成的主要内容,如果未能解决你的问题,请参考以下文章

MarkDown实现页内跳转

博客园--页内跳转

markdown页内跳转

markdown文本内跳转

MarkDown中实现目录页面内跳转

MarkDown:实现页内跳转