一份通俗易懂的Markdown教程

January 28, 2019

前言

Markdown是一种可以使用普通文本编辑器编写的标记语言,通过简单的标记语法,它可以使普通文本内容具有一定的格式。
Markdown的使用方法也是非常简单,不需要任何基础,你只需要会打出一些键盘上的常用字符就好了。

标题

Markdown的语法都非常好记,标题的语法为:

# + 空格 + 一级标题

空格是必不可少的,千万不要忘记了。

# 一级标题 <h1>
## 二级标题 <h2>
### 三级标题 <h3>
#### 四级标题 <h4>
##### 五级标题 <h5>

有几个#就是几级标题,一级标题是最大的标题,五级标题是最小的。

通过Shift键键盘上方的数字3组合使用打出 #

当然你也可以像html一样,将标题用两个#包裹住

# 一级标题 <h1> #
## 二级标题 <h2> ##
### 三级标题 <h3> ###
#### 四级标题 <h4> ####
##### 五级标题 <h5> #####

当然还是推荐第一种写法,比较方便

粗体、斜体、删除线

**粗体文字**
 _斜体文字_
~~被删除的文本~~

效果:粗体文字 斜体文字 被删除的文本

当然,这些属性可以被叠加。

**_~~粗体、斜体、删除文本~~_**

效果:粗体、斜体、删除文本

Shift + 键盘上方的8 = *Shift + 键盘上方的-(减号) = _Shift + 左上角~键 = ~

引用

> 我是一段被引用的文本

引用由>+ 空格 构成,不过不要开着输入法吧>打成

多级引用

想在引用中添加引用,该怎么办?
以下为错误示范

> 引用 > 二级引用

不不不,这样根本没有用,不要想当然地就这样做了。
多级引用的语法为:

> 一级引用
>> 二级引用
>>> 三级引用
>>>> 四级引用
......

有几个>就是几级引用

效果:

一级引用

二级引用

三级引用

四级引用

超链接

最简单的的超链接书写语法:

[链接文本](转向地址)

支持悬停显示信息的超链接:

[链接文本](转向地址 "悬停时显示信息")

其中引号必须为英文引号"",而不能为“”

锚点

[标题](#锚点ID)

和html的锚点几乎无差别,如果你不了解锚点,举个例子:当你用Github浏览md文件时,移动到标题上左边会出现一个小图标,点击即可移动到标题相应的位置,比如下面:

尝试点击我

 
 
 
 
 
 
 
我是一段被锚点的标题

换行符

Markdown并没有换行符,直接回车键换行并不能实现换行,若需要换行,直接在上一段文本后输入两个空格

你好  (←这里有俩空格)
真好

不过你也可以尝试直接在上一行文本和下一段文本之间留一段空行

你好

真好

不过这样做文本之间间距会比较大。

分割线

用三个-来创建一条水平直线。

---

当然,不一定必须要三个,你可以输入更多。

插入图片

![图片描述](图片地址)
![图片描述](图片地址 "悬停时提示信息")

前面了解了超链接,你应该已经掌握了,图片的插入方式也就是在前面加上!而已

列表

无序列表 <ul> -> <li>

在文本前加入- *或者+并打上空格来创建无序列表

- 列表项目
* 列表项目
+ 列表项目

有序列表 <ol> -> <li>

在文本前加入相应数字和.并打上空格来创建有序列表

1. 列表项目一
2. 列表项目二
3. 列表项目三

嵌套列表(多级列表)<ol>/<ul> -> <li> -> <ol>/<ul>

直接在子级列表前打上四个空格。
这里仅仅是做个示例,其实嵌套列表中无论是有序还是无序都没有关系

1.列表项
2.列表项
    -子项目
    -子项目
    -子项目
3.列表项

复选框

通常的复选框(在-[]复选框内容之间分别有一个空格):

- [] 复选框内容

被完成的复选框:

- [x] 复选框内容

不过这个复选框与html表单不同,它相当于一个列表,不过你可以通过复选框来表现列表项目是否被完成,一般用于计划清单

注:Typecho貌似不支持这个语法

代码框

如果是一段比较短的代码,嵌入在文本之中不换行(内联元素),这样书写:

`代码文字`

其中 ` 通过键盘左上角的波浪键(~)直接打出

如果是一段多行的长代码,直接在每一段代码之前追加四个空格:

    代码(在这段文本之前有四个空格)
    代码

也可以将代码用三个 ` 包裹

(```)   
代码
(```)

由于 ` 会被直接解析成代码框,所以这里加上括号,正常书写时不需要括号

语法高亮

如果代码需要准确的高亮显示,在代码的第一个三个 ` 后加上语言名称

(```php)
PHP语言代码
(```)

由于 ` 会被直接解析成代码框,所以这里加上括号,正常书写时不需要括号

表格

表头1|表头2|表头3
-:|:-:|:-
我是|表格|的吧
没错|你是|表格

效果:

表头1表头2表头3
我是表格的吧
没错你是表格

我这里对表格的css做了一些修改,正常写出来是你们理解的那种表格。

其实:-:表示表格一列内容居中,-:表示靠右显示,:-表示靠左显示
在表示内容对齐方式的:-: -: :-前面的是表头(表格标题)
其中的|表示表格线,这样就比较好理解了吧。

用html语法来理解markdown表格

其实如果你掌握了上面添加表格的方法,就可以不用看这里了。

首先有了:-: -: :-的出现,就构成了align<table>两个元素
也就是说,只有:-: -: :-才能够构成表格<table>

然后在:-: -: :-前面的是表格标题<th>

:-: -: :-后面的,是单元格<td>

每一个单元格<td>或者表头<th>,都要用|,来分割

每一行,无论是<td>还是<th>,都属于一个<tr>,只不过在Markdown里并不需要类似<tr>起始标签

打赏

标签:Markdown教程

最后编辑于:2019/05/26 04:32

回复