Markdown的快速上手教程
一篇关于MarkDown的简单教程,笔者觉得看完就能写
tips:本文所有的图片演示全部来源于VSCode预览页截图
前言
前两天写了一篇关于Hexo博客搭建的教程向文章,由于在Hexo中撰写博文需要以MarkDown语法书写,而且本人觉得原文附上的正经教学网站不一定适合各位去看,因此自己整理了一下MarkDown的各类语法写在下面,供大家撰写自己博文时参考
正文
编辑器推荐
-
笔者推荐,并且自己也在用,会在之后专门写一写关于VSCode的使用小建议
-
笔者较推荐,是我学习编程时用的第一款编辑器,相对来讲功能并没有VSC那么强大,但是配置要求很低,可以适配几乎一切设备
-
功能非常强大,但是对电脑配置有一定要求(需要C盘有足够的空间),而且对于新手不算友好,在这里不是很推荐
-
Notepad,又名记事本
经典文本编辑软件,不用多说大家都知道,使用极为方便
阅读体验直接飞升
Markdown 常用语法(入门)
标题
MarkDown支持多级标题,常用表述方法如下:
# 一级标题 |
Markdown最多支持六级标题,显示如下:
小贴士:在Hexo的某些主题中,生成文章时会按照标题结构生成目录,所以请尽量按照一级->二级->三级这样的顺序来写,避免出现不必要的错误
段落格式
Markdown的正文内容无需加入任何的修饰符,直接打字就好
注意段落间换行需要在行末添加两个以上空格并回车
或者直接在两行正文中间留一行空行
例如:
这是第一段 (注意这里我留了三个空格) |
或者
这是第一段 |
显示为:
字体
Markdown自身仅支持斜体,粗体,二者相加可以得到 粗斜体
写作:
*斜体* |
也可以写作:
_斜体_ (一个下划线) |
显示效果在本段开头已有体现
分隔线
如上,可以写作:
*** |
下划线,删除线
下划线在Markdown中没有特定的语法结构,我们使用HTML中的“<u></u>”标签来表达
写作:
<u>这是文本</u> |
删除线可以使用两个波浪线~~表示
写作:
~~这是文本~~ |
显示为:
链接与图片
首先我们介绍一下链接
写作:
[链接名字](链接地址) |
显示为:
不要点进去
图片和链接格式类似
只不过多了一步把图片地址渲染成一张图的操作
我们写作:
![图片名字](图片地址) |
这样你的图片就可以被插入到文字中
小贴士:使用hexo时如果不想将图片上传到网上,那需要将图片放在source文件夹中并把图片地址写成/图片名,例如我将一张名为pic.jpg的图片放在source文件夹中,那么图片地址就是/pic.jpg
更多的选择是将图片上传到在线图床,笔者文章中的图片全部都是上传到聚合图床之后引用的,具体操作方法是在上传后复制图床提供的网址作为图片地址
列表
Markdown支持有序列表和无序列表,写起来很相似
-
无序列表看起来像这样
-
它可以用这些方法表达
- 第一条 |
-
有序列表长这样
-
可以用如下方法表达
1. 第一条 |
-
可能会有人问:这样写出的有序列表和直接打字出现的结果一样,有什么意义呢?
-
因为他可以像这样嵌套列表
-
嵌套列表长这样
-
当然,嵌套顺序不是必要的,可以随便套
-
像这样
-
套娃 -
不许套娃
-
-
-
嵌套列表写起来也很简单,在嵌套内容的行首加四个空格(按一下Tab键)即可
像这样:
- 条目1 |
适度嵌套有益于逻辑表达,但切忌反复套娃
Markdown 常用语法(进阶)
前文的内容基本足够写出一篇图文并茂的文章了,接下来是一些进阶手法
区块
虽然名字很难懂,但是举个例子大家就懂了
这东西就叫区块
有的时候它也会被叫做“引用”(实际上它应用面很广,不但可以引用,还可以达到诸如强调提示等等多种效果)
通过在行首添加一个大于号“>"和一个空格来表达
写法如下:
> 文字内容 |
像列表一样,区块也可以嵌套
写起来像这样:
> 第一层 |
注意每一个“>”后面都要有空格
显示为:
第一层
第二层
第三层
区块也可以放进列表中,使用方法和列表嵌套相同:
- 第一条 |
显示为:
-
第一条
区块1
区块2
-
第二条
列表也可以放进区块里,写法如下:
> 区块 |
显示为:
区块
- 无序列表1
- 无序列表2
- 有序列表1
- 有序列表2
代码
代码在本文已经出现了很多次,对于一些教程文是很有必要的存在
本段将会多次使用符号“ ` ”,该标点位于键盘左上角,一般在数字1左面,英文输入模式下输入为" ` ",中文模式下为“ · ”,注意区分
单行代码的引用这样写:
`print("Hello,World")` |
显示为:
print("Hello,World")
多行代码(又称作代码块)有两种写法
- 在每一行的行首多加四个空格(按一下Tab)
- 优点:书写方便
- 缺点:不能添加语言类别
可以这样写:
int main() |
显示为:
int main()
{
printf("Hello,World");
return 0;
}
- 在代码块的开头和结尾各加一行“```”
- 优点:可以著名语言类别,在接下来的演示中会有
- 缺点:书写麻烦
可以写作:
(此处Markdown在渲染时出现了严重的冲突问题,不得已只能换成图片展示)
显示为:
|
可以注意到,在我的主题中代码类别可以显示在代码块上方,这样对于一些复杂内容有助于理解
表格
Markdown可以用于绘制表格
此处用到的“ | ”符号一般位于中括号键右侧,按住Shift时输入“ | ”,不按Shift输入“、”(中文)“ \ "(英文),注意识别
写作:
| 表头 | 表头 | |
表示为:
表头 | 表头 |
---|---|
单元格 | 单元格 |
单元格 | 单元格 |
可以对其进行进一步排版设计:
| 左对齐 | 右对齐 | 居中对齐 | |
显示为:
左对齐 | 右对齐 | 居中对齐 |
---|---|---|
单元格11111 | 单元格22222 | 单元格33333 |
单元格11111 | 单元格22222 | 单元格33333 |
Markdown 高级技巧
Markdown支持部分HTML标签,若需进一步美化格式请自行学习HTML相关知识
Markdown还支持KaTex或MathJax生成数学公式,如有需求请自行查阅相关资料
总结
Markdown作为一门轻量级标记语言一直被全球程序员所喜爱,同样Hexo的使用也离不开Markdown。希望本文能作为各位撰写博文时的一份参考。
当然,尽可能做到流畅的自主书写也很重要的。祝各位早日上手Markdown.
临近高考季,祝高三学长们学业有成,金榜题名!
版权声明:本博客所有文章除特别声明外,均采用 CC BY-SA 4.0 协议 ,转载请注明出处!