Markdown的快速上手教程

一篇关于MarkDown的简单教程,笔者觉得看完就能写

tips:本文所有的图片演示全部来源于VSCode预览页截图

前言

前两天写了一篇关于Hexo博客搭建的教程向文章,由于在Hexo中撰写博文需要以MarkDown语法书写,而且本人觉得原文附上的正经教学网站不一定适合各位去看,因此自己整理了一下MarkDown的各类语法写在下面,供大家撰写自己博文时参考

正文

编辑器推荐

  • Visual Studio Code

    笔者推荐,并且自己也在用,会在之后专门写一写关于VSCode的使用小建议

  • Notepad++

    笔者较推荐,是我学习编程时用的第一款编辑器,相对来讲功能并没有VSC那么强大,但是配置要求很低,可以适配几乎一切设备

  • Visual Studio

    功能非常强大,但是对电脑配置有一定要求(需要C盘有足够的空间),而且对于新手不算友好,在这里不是很推荐

  • Notepad,又名记事本

    经典文本编辑软件,不用多说大家都知道,使用极为方便 阅读体验直接飞升

Markdown 常用语法(入门)

标题

MarkDown支持多级标题,常用表述方法如下:

# 一级标题

## 二级标题

### 三级标题

......

Markdown最多支持六级标题,显示如下:

标题

小贴士:在Hexo的某些主题中,生成文章时会按照标题结构生成目录,所以请尽量按照一级->二级->三级这样的顺序来写,避免出现不必要的错误

段落格式

Markdown的正文内容无需加入任何的修饰符,直接打字就好

注意段落间换行需要在行末添加两个以上空格并回车

或者直接在两行正文中间留一行空行

例如:

这是第一段   (注意这里我留了三个空格)
这是第二段

或者

这是第一段

这是第二段

显示为:

正文

字体

Markdown自身仅支持斜体粗体,二者相加可以得到 粗斜体

写作:

*斜体*
**粗体**
***粗斜体***

也可以写作:

_斜体_        (一个下划线)
__粗体__ (两个下划线)
___粗斜体___ (三个下划线)

显示效果在本段开头已有体现

分隔线


如上,可以写作:

***
* * *
*****
- - -
-----
可以概括为三个及以上星号*或减号-

下划线,删除线

下划线在Markdown中没有特定的语法结构,我们使用HTML中的“<u></u>”标签来表达

写作:

<u>这是文本</u>

删除线可以使用两个波浪线~~表示

写作:

~~这是文本~~

显示为:

删除线

链接与图片

首先我们介绍一下链接

写作:

[链接名字](链接地址)

显示为:

链接名字

不要点进去

图片和链接格式类似

只不过多了一步把图片地址渲染成一张图的操作

我们写作:

![图片名字](图片地址)

这样你的图片就可以被插入到文字中

小贴士:使用hexo时如果不想将图片上传到网上,那需要将图片放在source文件夹中并把图片地址写成/图片名,例如我将一张名为pic.jpg的图片放在source文件夹中,那么图片地址就是/pic.jpg

更多的选择是将图片上传到在线图床,笔者文章中的图片全部都是上传到聚合图床之后引用的,具体操作方法是在上传后复制图床提供的网址作为图片地址

列表

Markdown支持有序列表和无序列表,写起来很相似

  • 无序列表看起来像这样

  • 它可以用这些方法表达

- 第一条

- 第二条


+ 第一条

+ 第二条


* 第一条

* 第二条
  1. 有序列表长这样

  2. 可以用如下方法表达

1. 第一条

2. 第二条
  1. 可能会有人问:这样写出的有序列表和直接打字出现的结果一样,有什么意义呢?

  2. 因为他可以像这样嵌套列表

    • 嵌套列表长这样

    • 当然,嵌套顺序不是必要的,可以随便套

      • 像这样

        1. 套娃

        2. 不许套娃

嵌套列表写起来也很简单,在嵌套内容的行首加四个空格(按一下Tab键)即可

像这样:

- 条目1
- 条目1.1
- 条目1.1.1

或者

1. 条目1
1. 条目1.1
1. 条目1.1.1

适度嵌套有益于逻辑表达,但切忌反复套娃

Markdown 常用语法(进阶)

前文的内容基本足够写出一篇图文并茂的文章了,接下来是一些进阶手法

区块

虽然名字很难懂,但是举个例子大家就懂了

这东西就叫区块

有的时候它也会被叫做“引用”(实际上它应用面很广,不但可以引用,还可以达到诸如强调提示等等多种效果)

通过在行首添加一个大于号“>"和一个空格来表达

写法如下:

> 文字内容

像列表一样,区块也可以嵌套

写起来像这样:

> 第一层
> > 第二层
> > > 第三层

注意每一个“>”后面都要有空格

显示为:

第一层

第二层

第三层

区块也可以放进列表中,使用方法和列表嵌套相同:

- 第一条
> 区块1

> 区块2
- 第二条

显示为:

  • 第一条

    区块1

    区块2

  • 第二条

列表也可以放进区块里,写法如下:

> 区块
> - 无序列表1
> - 无序列表2
> 1. 有序列表1
> 2. 有序列表2

显示为:

区块

  • 无序列表1
  • 无序列表2
  1. 有序列表1
  2. 有序列表2

代码

代码在本文已经出现了很多次,对于一些教程文是很有必要的存在

本段将会多次使用符号“ ` ”,该标点位于键盘左上角,一般在数字1左面,英文输入模式下输入为" ` ",中文模式下为“ · ”,注意区分

单行代码的引用这样写:

`print("Hello,World")`

显示为:

print("Hello,World")

多行代码(又称作代码块)有两种写法

  • 在每一行的行首多加四个空格(按一下Tab)
    • 优点:书写方便
    • 缺点:不能添加语言类别

可以这样写:

int main()
{
printf("Hello,World");
return 0;
}

显示为:

int main()
{
    printf("Hello,World");
    return 0;
}
  • 在代码块的开头和结尾各加一行“```”
    • 优点:可以著名语言类别,在接下来的演示中会有
    • 缺点:书写麻烦

可以写作:

代码块

(此处Markdown在渲染时出现了严重的冲突问题,不得已只能换成图片展示)

显示为:

#include <iostream>
int main()
{
std::cout<<"Hello,World";
return 0;
}

可以注意到,在我的主题中代码类别可以显示在代码块上方,这样对于一些复杂内容有助于理解

表格

Markdown可以用于绘制表格

此处用到的“ | ”符号一般位于中括号键右侧,按住Shift时输入“ | ”,不按Shift输入“、”(中文)“ \ "(英文),注意识别

写作:

|  表头   | 表头  |
| ---- | ---- |
| 单元格 | 单元格 |
| 单元格 | 单元格 |

表示为:

表头 表头
单元格 单元格
单元格 单元格

可以对其进行进一步排版设计:

| 左对齐 | 右对齐 | 居中对齐 |
| :-----| ----: | :----: |
| 单元格 | 单元格 | 单元格 |
| 单元格 | 单元格 | 单元格 |

显示为:

左对齐 右对齐 居中对齐
单元格11111 单元格22222 单元格33333
单元格11111 单元格22222 单元格33333

Markdown 高级技巧

Markdown支持部分HTML标签,若需进一步美化格式请自行学习HTML相关知识

Markdown还支持KaTex或MathJax生成数学公式,如有需求请自行查阅相关资料

HTML相关教程(来自菜鸟教程)

KaTex的Github

MathJax的Github

总结

Markdown作为一门轻量级标记语言一直被全球程序员所喜爱,同样Hexo的使用也离不开Markdown。希望本文能作为各位撰写博文时的一份参考。

当然,尽可能做到流畅的自主书写也很重要的。祝各位早日上手Markdown.


临近高考季,祝高三学长们学业有成,金榜题名!

版权声明:本博客所有文章除特别声明外,均采用 CC BY-SA 4.0 协议 ,转载请注明出处!