1.引导语
本人在实际工作或学习中,有时候会用到markdown语法,但是鉴于目前大部分搜索到的比较冗杂,并不适合刚接触该语法的小白
,所以,本人根据自己的经验,制作一个专为小白而生的文档,小白只需要根据文档大纲,找到自己需要的功能(也是本人平常所用的功能,都是最基础的),点击对应的标题,即可转跳到对应的实现方式,方便大家的同时,也起到了记录笔记的作用,该文章会随本人实际所用到的功能而持续更新
,欢迎大家收藏
,并留言自己想了解的语法
,我来进行该文档的补充~~
2.快捷键
该处收集的是各个使用方式的快捷键,根据本人的经验来看,有时候快捷键不如直接写符号好用
功能 | 快捷键 |
---|---|
标题 | Ctrl+Shift+H |
字体加粗 | Ctrl+B |
斜体 | Ctrl+I |
3.目录
关于MarkDown语法的目录,相信大多数人都比较熟悉,在这里,为了让小白了解原理,此处做了目录的演示与说明
- 如果需要使用目录功能,只需要在
文本的开头添加@[TOC]
- 如果不添加后面的(),则默认显示目录,添加括号后,则显示括号后的内容,如示例所示
- 剩余的目录结构,会根据标题完成自动的填充
@[TOC](文档大纲)
# 目录的使用演示
# 目录自动填充的一级标题
## 目录自动填充的二级标题
### 目录自动填充的三级标题
# 目录自动填充的一级标题
效果展示图:
4.标题
在文字的开头,添加#,然后按下空格键,再输入标题内容,即可实现该文档的标题
,如下面的文档所示
备注:标题和目录可以实现梦幻联动,形成一个整体的目录结构
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题
5.常用文字格式
5.1 加粗
示例:这是一段粗体
**这是一段粗体**
----------------
详细解析:markdown语法中,不支持自定义粗度,试着接受默认的加粗程度即可
5.2 斜体
示例:这是一段斜体
*这是一段斜体*
----------------
详细解析:默认倾斜程度,接受即可
6.文字链接
实现方式一:行内式
示例:链接: 码云-技术文档
链接: [link](https://gitee.com/jbx123/technical-documentation)
---------------------------------------
详细解析:[]里写链接文字,()里写链接地址
实现方式二:参考式
参考式超链接一般用在学术论文上面,或者另一种情况,如果某一个链接在文章中多处使用,那么使用引用 的方式创建链接将非常好,它可以让你对链接进行统一的管理。
这是我的[码云][1],资料来源为[百度][2]、[csdn][3]等
[1]:https://gitee.com/jbx123/technical-documentation "码云"
[2]:https://www.baidu.com/ "百度"
[3]:https://www.csdn.net/ "csdn"
---------------------------------
详细解析:
1. 把需要弄成链接的文字,用[]括起来 [码云]
2. 第一步万抽,添加的文字后面,再添加个[1] [码云][1]
3. 另起一行,在第二部的序号后面添加: [1]:
4. 添加链接 [1]:https://gitee.com/jbx123/technical-documentation
5. 完成步骤四后,按空格
6. 完成步骤五后,添加步骤一的文字 [1]:https://gitee.com/jbx123/technical-documentation "码云"
实现方式三:自动链接
Markdown 支持以比较简短的自动链接形式来处理网址和电子邮件信箱,只要是用<>包起来, Markdown 就会自动把它转成链接。一般网址的链接文字就和链接地址一样,例如:
示例:https://www.baidu.com/
<https://www.baidu.com/>
详细解析:在<>号中添加网址即可
7.锚点
利用锚点,可以实现类似目录的功能
注意: Markdown Extra 只支持在标题后插入锚点,其它地方无效。
锚点目录
锚点一
锚点二
## 锚点目录
- [点击跳转到锚点一](#锚点一)
- [点击跳转到锚点二](#锚点二)
### 锚点一
### 锚点二
--------------------------
详细解析:
1. 先创建好标题
2. 在需要进行跳转的地方,用[]括住跳转文字描述 --- [点击跳转到锚点一]
3. 然后在该[]后,添加() ---[点击跳转到锚点一]()
4. 完成步骤3后,在括号内添加标题名称 ---[点击跳转到锚点一](#锚点一)
5. 完成锚点的制作
8.分割线
你可以在一行中用三个以上的星号、减号、底线来建立一个分隔线,行内不能有其他东西。你也可以在星号或是减号中间插入空格。下面每种写法都可以建立分隔线:
***
* * *
*****
- - -
---------------------------------------
详细解析:上面的任意一行,都可以实现分割线的效果