markdown中锚链接实现目录跳转以及注意事项
2024-09-06 04:47:27
本文在这里可以更友好的阅读:Link
当文章有分类,需要快速阅读,通常会先在文首部写一个目录,点击可以跳转。
为文章写目录,特别在文章较长的时候,有助于对内容的整体把握,能提高阅读效率。
以下,将写一个基本的锚目录demo,然后特别说明需要注意的几点。
Table Of Content
Demo
Table Of Contents
Installation Instructions
Usage Instructions
Troubleshooting
Compatibility
Notes and Miscellaneous
Building the Extension Bundles
Next Steps, Credits, Feedback, License
Something you should know
Installation Instructions
blablablabla
Usage Instructions
blablablabla
Troubleshooting
blablablabla
Compatibility
blablablabla
Notes and Miscellaneous
blablablabla
Building the Extension Bundles
blablablabla
Next Steps
blablablabla
Credits
blablablabla
Feedback
blablablabla
用htmla标签实现的锚链接
除了用markdown中的锚定义,我们还可以在需要的时候使用html中的a链接的name属性。实现传统的锚点。
//点击:
<a href="#test">Something you should know</a>
//跳转至:
<a name="test">用htmla标签实现的锚链接</a>
注意:markdown 的锚使用中需要特别注意的几点
语法
目录(Table Of Content)
[链接的value值,任意名称](#*1 anchor-name)
锚
#*n Anchor Name
//可以是一级标题、二级、三级····
1. 命名规则
在目录中:
- 链接的名称anchor-name必须全部是小写的,和锚中的名称不区分大小写匹配
- anchor-name对应的锚的名称中的空格要用
“-”
替换 - anchor-name不能含有
“:”
、“()”
、“.”
、%
、$
等等特殊字符,最好就不要有任何字符 - 目录的部分可以是多种样式,例如斜体,粗体,本身都是等级标题,甚至列表元素都行
在锚中:
(指的是正文的标题)
- 不能含有
“:”
、“()”
、“.”
等字符 - 锚不能是列表元素,例如无序列表
*
- 锚只要是标题就行,他可以是任意等级
2. 如果锚需要特殊符号该怎么办?
写url的时候anchor-name 直接跳过全部的特殊字符即可,如下示例:
本文在这里可以更友好的阅读:Link
本文源markdown文档可以在这里查看:Link
最新文章
- Android开源图表之树状图和饼状图的官方示例的整理
- Android相机使用(系统相机、自定义相机、大图片处理)
- Java 继承 执行顺序
- VHDL学习札记:library and Package
- MySQL分区表例子——List分区
- MapObject shape数据操作
- 内核操作系统Linux内核变迁杂谈——感知市场的力量
- oracle创建数据库到2%不动问题
- Android视频媒体相关,VideoView和开源框架vitamio
- Python爬虫入门教程 17-100 CSD*博客抓取数据
- Redis的安装、配置及测试
- JS类型转换(强制和自动的规则)
- VMware vSphere虚拟化-VMware ESXi 5.5组件安装过程记录
- UI自动化(二)css选择器
- Leetcode 题解 Jump Game
- SpringBoot 热启动
- 【AtCoder】ARC099题解
- 接口自动化平台github开源项目Django
- bzoj 1899 贪心+dp
- 【转】Microsoft .Net Remoting之Marshal、Disconnect与生命周期以及跟踪服务
热门文章
- 01 ORM框架概述
- docker的安装使用
- Gnome 究极无死角美化!!!不要再说gnome丑啦!!!
- IoT设备实践丨如果你也在树莓派上部署了k3s,你也许需要这篇文章
- 开放融合易用@门户移动开发新体验-逐浪CMS v8.0.1全面发布
- 数据挖掘入门系列教程(四)之基于scikit-lean实现决策树
- Google Flutter Clock 大赛优秀项目推荐
- Python下载各种功能包出问题
- Natas27 Writeup(mysql溢出截断漏洞)
- Leetcode_1048. 最长字符串链