边写边学的Markdown之旅
为了提升自我的知识水平、书写水平、归纳总结水平,进而提高综合能力,这就学习了Markdown简单使用方法。这真是一门优秀、方便 、高效的标记语言。无论是应对记录日记闲谈,编写技术文档都可以无压力胜任。所以也来做一个边写边学的文档好了。
工具
Markdown语言本身就是普通的文本,不需要配什么使用环境。编辑工具推荐使用巨硬家的Visual Studio Code,配合Code插件库里的Markdown插件使用,简直方便。
目录
- 标题
- 正文
- 占位符
- 换行
- 高亮
- 斜体粗体
- 删除线
- 分隔线
- 脚注
- 列表
- 无序列表
- 有序列表
- todo列表
- 链接
- 超链接
- 图片
- 脚注超链接
- 引用
- 普通引用
- 代码引用
- 表格
- 制作目录
- 其他
标题
使用#
来标记为标题,最多可以到6级标题
# h1
## h2
### h3
#### h4
##### h5
###### h6
正文
正文自然是没有什么骚操作,正常写就是了。不过这里有几个小技巧需要注意。
占位符
每一段文字的开头,也许会想空两个字,这时就需要使用占位符
“我轻轻的离去,没带走半个比特币,甚至还亏了不少。”
换行
这个不用多说,硬需求。
只需在行末加两个空格,然后回车即可。
高亮
`这样使用`
效果:
这样使用
斜体粗体
*斜体*
**粗体**
***斜粗体***
效果:
斜体
粗体
斜粗体
删除线
在文字的左右两边放两个~
~~就像这个~~
,效果如下:
就像这个
分隔线
***
/___
/---
都可以表示为分隔线。
注意使用---
的时候,前面必须空一行,否则会使上一行变成标题。
效果:
脚注
使用脚注,首先需要在文章最后定义脚注:
[^脚注名]: 一句话注释。或者跳转链接
使用的时候只需要在想注释的地方插入[^脚注名]
即可。
列表
Markdown支持以下几种列表。
无序列表
使用* 列表名
即可标记为无序列表。子级列表比父级列表多一个tab缩进即可。
- 一级列表1
- 二级列表1
- 三级列表1
- 三级列表2
- 二级列表2
效果:
- 一级列表1
- 二级列表1
- 三级列表1
- 三级列表2
- 二级列表2
有序列表
有序列表与无序列表相似,只是将*
换成了数字.
1. 第一章
1. 第一节
1. 第一条
2. 第二节
效果:
- 第一章
- 第一节
- 第一条
- 第二节
todo列表
todo List yeah![1]
每天都要做的事:
* [ ] 吃肉
+ [x] 喝水
- [x] 干活
效果:
- [ ] 吃肉
- [x] 喝水
- [x] 干活
链接
超链接
插入超链接使用以下格式:
[显示文字](链接地址)
全球最大的同性交友网站在哪里,[点击跳转](http://www.github.com)。
效果:
全球最大的同性交友网站在哪里,点击跳转。
图片
插入图片使用以下格式:
!
[图片描述]
(图片地址)
,图片描述可以为空。
![垃圾平台,坑我钱财,毁我青春](http://upload-images.jianshu.io/upload_images/73064-105883d76ec68ca9.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)
效果:
(滑稽)
脚注超链接
在一些平台,超链接还支持脚注超链接:
在要使用的小节最后添加脚注:
格式:
[名字]: 链接地址
[1]: http://stackoverflow.com
然后在想要使用的地方:
代码遇到问题,去哪里?[点击跳转][1]
效果:
代码遇到问题,去哪里?点击跳转
引用
普通引用
单纯使用一个缩进开头,即可完成普通行引用,引用前需要空出一行才能生效。
这种引用会让引用文字中的Markdown语法失效,不过很适合拿来做Markdown语法教程!?
使用tab或
4个空格开头即可
# 我是标题,但我没生效欸
*** 分隔线表示心里平衡
使用> 开头
即可标记为引用
如果想再引用中插入前一种引用需要开头缩进两个Tab不缩进是不可能的,那这辈子都是出不来引用效果的。
代码引用
使用如下格式即可对代码块完成引用:
``` 代码语言
代码
```
``` Java
public interface IView {
void show();
void hide();
}
```
效果:
public interface IView {
void show();
void hide();
}
表格
| 水果 | 价格 | 数量 |
| :---: | ---- | ---: |
| 香蕉 | 1元 | 5 |
| 苹果 | 2元 | 6 |
| 草莓 | 3元 | 7 |
第二行为每一列的文字重力做出描述,默认居左---
/居右---:
/居中:---:
。
效果:
水果 价格 数量 香蕉 1元 5 苹果 2元 6 草莓 3元 7
制作目录
其实这个功能,还是看例子比较好。
就拿这整篇文章做例子吧。
- [标题](#标题)
- [正文](#正文)
- [占位符](#占位符)
- [换行](#换行)
- [高亮](#高亮)
- [斜体粗体](#斜体粗体)
- [删除线](#删除线)
- [分隔线](#分隔线)
- [脚注](#脚注)
- [列表](#列表)
- [无序列表](#无序列表)
- [有序列表](#有序列表)
- [todo列表](#todo列表)
- [链接](#链接)
- [超链接](#超链接)
- [图片](#图片)
- [脚注超链接](#脚注超链接)
- [引用](#引用)
- [普通引用](#普通引用)
- [代码引用](#代码引用)
- [表格](#表格)
- [制作目录](#制作目录)
- [其他](#其他)
如聪明的你所见,这就整个一链接的格式嘛,只不过前面多一个-
,再配合缩进分级而已。
不得不说Markdown大法好啊!
其他
以上就是常用的Markdown基本语法,已经能够解决我的文字编写需求啦。还有像数学公式
,流程图
,序列图
,甘特图
等高级使用方式,暂时用不上,就先不学啦。
放空自我
->从心
->怂
感谢阅读
-
其实很多地方-、+、*三个符号都可以互换,它们都起到相同的作用。 ↩