置顶 |

Markdown基础教程


阅读数: 次   

本文记录了Markdown的编写方式。

一.标题

1. 使用 = 和 - 标记一级和二级标题

语法：

  • = 与 - 放在内容下面一行。

例如：

1
2
3
4
这是一个一级标题
=
这是一个二级标题
-

这是一个一级标题

这是一个二级标题

2. 使用 # 号标记

语法：使用 # 号可表示 1-6级标题，一级标题对应一个 # 号，二级标题对应两个 # 号，以此类推。#与标题之间需要一个空格。

例如：

1
2
3
4
5
6
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题

一级标题

二级标题

三级标题

四级标题

五级标题
六级标题

二.段落格式

语法:

  • 段落的换行是使用两个以上空格加上回车

  • 也可以在段落后面使用一个空行来表示重新开始一个段落

例如： 

1
2
3
末尾添加两个空格，再加上回车  
使用一个空行来表示重新开始一个段落，即按两次回车
新的一行

末尾添加两个空格，再加上回车
使用一个空行来表示重新开始一个段落，即按两次回车

新的一行

三.字体

语法：如下
例如： 

1
2
3
4
5
6
*斜体文本*
_斜体文本_
**粗体文本**
__粗体文本__
***粗斜体文本***
___粗斜体文本___

四.分割线

语法：

  • 你可以在一行中用三个以上的星号、减号、底线来建立一个分隔线，行内不能有其他东西。你也可以在星号或是减号中间插入空格。下面每种写法都可以建立分隔线：
1
2
3
4
5
***
* * *
*****
- - -
----------

五.删除线

语法：

  • 如果段落上的文字要添加删除线，只需要在文字的两端加上两个波浪线 ~~ 即可。 不需要空格。

例如：

1
2
哈哈  
~~哈哈~~

哈哈
哈哈

六.下划线

语法：

  • 下划线可以通过 HTML 的 
1
2
<u> 标签来实现
<u>这中间的东西会带下划线</u>

显示效果如下所示： 这中间的东西会带下划线

七.脚注

语法：

  • 在上面写：[^要注明的文本]
  • 在下面写：[^要注明的文本]：解释的内容
1
2
haha[^一个脚注]
[^一个脚注]:哈哈

haha^一个脚注
hehe^另一个脚注

八.列表

语法：

  • Markdown 支持无序列表和有序列表。

1.无序列表

语法：

  • 无序列表使用星号(*)、加号(+)或是减号(-)作为列表标记
    例如：
1
2
3
4
5
6
7
8
9
10
11
12
* 第一项
* 第二项
* 第三项

+ 第一项
+ 第二项
+ 第三项


- 第一项
- 第二项
- 第三项
  • 第一项
  • 第二项
  • 第三项
  • 第一项
  • 第二项
  • 第三项
  • 第一项
  • 第二项
  • 第三项

2.有序列表

语法：

  • 有序列表使用数字并加上 . 号来表示。

例如： 

1
2
3
1. 第一项
2. 第二项
3. 第三项
  1. 第一项
  2. 第二项
  3. 第三项

3.列表嵌套

语法：

  • 列表嵌套只需在子列表中的选项添加四个空格即可

例如： 

1
2
3
4
5
6
7
8
9
- 第一项
    - 第一个
    - 第二个
- 第二项
    - 第一个
    - 第二个  
- 第三项  
    - 第一个 
    - 第二个
  • 第一项
    • 第一个
    • 第二个
  • 第二项
    • 第一个
    • 第二个
  • 第三项
    • 第一个
    • 第二个
1
2
3
4
5
6
1. 第一项：    
    - 第一个
    - 第二个
2. 第二项：
    - 第一个
    - 第二个
  1. 第一项：
    • 第一个
    • 第二个
  2. 第二项：
    • 第一个
    • 第二个

九.Markdown 区块

语法：

  • Markdown 区块引用是在段落开头使用 > 符号 ，然后后面紧跟一个空格符号
  • 区块是可以嵌套的，一个 > 符号是最外层，两个 > 符号是第一层嵌套，以此类推退。
1
2
> 哈哈
>> 嘿嘿

哈哈

嘿嘿

1.区块中使用列表

1
2
3
4
5
> 区块中使用列表  
> 1. 第一项
> 2. 第二项
>    - 第一个
>    - 第二个

区块中使用列表

  1. 第一项
  2. 第二项
    • 第一个
    • 第二个

2.列表中使用区块

语法：

  • 如果要在列表项目内放进区块，那么就需要在 > 前添加四个空格的缩进。

例如：

1
2
3
4
5
6
- 第一项  
    > 第一个  
    > 第二个  
- 第二项  
    > 第一个  
    > 第二个
  • 第一项

    第一个
    第二个

  • 第二项

    第一个
    第二个

十.Markdown 代码

1.一个函数或片段的代码

  • 如果是段落上的一个函数或片段的代码可以用反引号把它包起来。
    例如： 
1
`printf("Hello world!");`

printf("Hello world!");

2.代码区块

  • 代码区块使用 4 个空格或者一个制表符（Tab 键）。 (最好与上面有两行的空行)
你也可以用 ```包裹一段代码，并指定一种语言（也可以不指定）：
1
2
3
4
5
6
#include <stdio.h>
int main()
{
    printf("Hello world!");
    return 0;
}

十一.Markdown 链接

语法： 

1
2
3
[链接名称](链接地址)  
 或者  
 <链接地址>

例如：

高级链接

语法： 

1
2
3
4
链接也可以用变量来代替，文档末尾附带变量地址：
[第一][第二]
然后在文档的结尾为变量赋值（网址）  
[第二]：网址

例如： 

1
2
3
[baidu][1]   //这里的数字可以用汉字代替
  
[1]:https://www.baidu.com/

baidu

十二.Markdown 图片

语法：

  • 开头一个感叹号 !

接着一个方括号，里面放上图片的替代文字

接着一个普通括号，里面放上图片的网址，最后还可以用引号包住并加上选择性的 ‘title’ 属性的文字。

例如： 

1
![向日葵](https://timgsa.baidu.com/timg?image&quality=80&size=b9999_10000&sec=1573787844528&di=24aaf71c175abe46a9deb373e29388aa&imgtype=0&src=http%3A%2F%2Fb.hiphotos.baidu.com%2Fimage%2Fpic%2Fitem%2F908fa0ec08fa513db777cf78376d55fbb3fbd9b3.jpg)

向日葵

  • 也可以像网址那样对图片网址使用变量

例如： 

1
2
3
[夜景][汉字] 
  
[汉字]:https://timgsa.baidu.com/timg?image&quality=80&size=b9999_10000&sec=1573787844527&di=f5983076e169208a621cb5ce161c5b03&imgtype=0&src=http%3A%2F%2Fb.hiphotos.baidu.com%2Fimage%2Fpic%2Fitem%2F0eb30f2442a7d9337119f7dba74bd11372f001e0.jpg

夜景

十三.表格

  • Markdown 制作表格使用 | 来分隔不同的单元格，使用 - 来分隔表头和其他行。

例如：

1
2
3
4
5
6
7
8
9
|  表头   | 表头  |
|  ----  | ----  |
| 单元格  | 单元格 |
| 单元格  | 单元格 |  

header 1 | header 2
---|---
row 1 col 1 | row 1 col 2
row 2 col 1 | row 2 col 2
表头 表头
单元格 单元格
单元格 单元格
header 1 header 2
row 1 col 1 row 1 col 2
row 2 col 1 row 2 col 2
  • 对齐方式

我们可以设置表格的对齐方式：
-: 设置内容和标题栏居右对齐。
:- 设置内容和标题栏居左对齐。
:-: 设置内容和标题栏居中对齐。

1
2
3
4
 | 左对齐 | 右对齐 | 居中对齐 |
| :-----| ----: | :----: |
| ha    |    ha |     ha |
| 单元格 | 单元格 | 单元格 |
左对齐 右对齐 居中对齐
ha ha ha
单元格 单元格 单元格

十四.Markdown一些其他基础

1.支持的 HTML 元素

不在 Markdown 涵盖范围之内的标签，都可以直接在文档里面用 HTML 撰写。
目前支持的 HTML 元素有：<kbd> <b> <i> <em> <sup> <sub> <br>等 
如：  
使用 <kbd>Ctrl</kbd>+<kbd>Alt</kbd>+<kbd>Del</kbd> 重启电脑

2.转义

Markdown 使用了很多特殊符号来表示特定的意义，如果需要显示特定的符号则需要使用转义字符，Markdown 使用反斜杠转义特殊字符：    
1
2
**文本加粗** 
\*\* 正常显示星号 \*\*

文本加粗

** 正常显示星号 ** 

1
2
3
4
5
6
7
8
9
10
11
12
13
还有这些字符可以转义：  
\   反斜线
`   反引号
*   星号
_   下划线
{}  花括号
[]  方括号
()  小括号
#   井字号
+   加号
-   减号
.   英文句点
!   感叹号

3.公式

语法：

  • 当你需要在编辑器中插入数学公式时，可以使用两个美元符 $$ 包裹 TeX 或 LaTeX 格式的数学公式来实现。提交后，问答和文章页会根据需要加载 Mathjax 对数学公式进行渲染。 
1
2
3
4
5
6
7
8
$$
\mathbf{V}_1 \times \mathbf{V}_2 =  \begin{vmatrix} 
\mathbf{i} & \mathbf{j} & \mathbf{k} \\
\frac{\partial X}{\partial u} &  \frac{\partial Y}{\partial u} & 0 \\
\frac{\partial X}{\partial v} &  \frac{\partial Y}{\partial v} & 0 \\
\end{vmatrix}
$$tep1}{\style{visibility:hidden}{(x+1)(x+1)}}
$$

本文记录了Markdown的编写方式。

一.标题

1. 使用 = 和 - 标记一级和二级标题

语法：

  • = 与 - 放在内容下面一行。

例如：

1
2
3
4
这是一个一级标题
=
这是一个二级标题
-

这是一个一级标题

这是一个二级标题

2. 使用 # 号标记

语法：使用 # 号可表示 1-6级标题，一级标题对应一个 # 号，二级标题对应两个 # 号，以此类推。#与标题之间需要一个空格。

例如：

1
2
3
4
5
6
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题

一级标题

二级标题

三级标题

四级标题

五级标题
六级标题

二.段落格式

语法:

  • 段落的换行是使用两个以上空格加上回车

  • 也可以在段落后面使用一个空行来表示重新开始一个段落

例如： 

1
2
3
末尾添加两个空格，再加上回车  
使用一个空行来表示重新开始一个段落，即按两次回车
新的一行

末尾添加两个空格，再加上回车
使用一个空行来表示重新开始一个段落，即按两次回车

新的一行

三.字体

语法：如下
例如： 

1
2
3
4
5
6
*斜体文本*
_斜体文本_
**粗体文本**
__粗体文本__
***粗斜体文本***
___粗斜体文本___

四.分割线

语法：

  • 你可以在一行中用三个以上的星号、减号、底线来建立一个分隔线，行内不能有其他东西。你也可以在星号或是减号中间插入空格。下面每种写法都可以建立分隔线：
1
2
3
4
5
***
* * *
*****
- - -
----------

五.删除线

语法：

  • 如果段落上的文字要添加删除线，只需要在文字的两端加上两个波浪线 ~~ 即可。 不需要空格。

例如：

1
2
哈哈  
~~哈哈~~

哈哈
哈哈

六.下划线

语法：

  • 下划线可以通过 HTML 的 
1
2
<u> 标签来实现
<u>这中间的东西会带下划线</u>

显示效果如下所示： 这中间的东西会带下划线

七.脚注

语法：

  • 在上面写：[^要注明的文本]
  • 在下面写：[^要注明的文本]：解释的内容
1
2
haha[^一个脚注]
[^一个脚注]:哈哈

haha^一个脚注
hehe^另一个脚注

八.列表

语法：

  • Markdown 支持无序列表和有序列表。

1.无序列表

语法：

  • 无序列表使用星号(*)、加号(+)或是减号(-)作为列表标记
    例如：
1
2
3
4
5
6
7
8
9
10
11
12
* 第一项
* 第二项
* 第三项

+ 第一项
+ 第二项
+ 第三项


- 第一项
- 第二项
- 第三项
  • 第一项
  • 第二项
  • 第三项
  • 第一项
  • 第二项
  • 第三项
  • 第一项
  • 第二项
  • 第三项

2.有序列表

语法：

  • 有序列表使用数字并加上 . 号来表示。

例如： 

1
2
3
1. 第一项
2. 第二项
3. 第三项
  1. 第一项
  2. 第二项
  3. 第三项

3.列表嵌套

语法：

  • 列表嵌套只需在子列表中的选项添加四个空格即可

例如： 

1
2
3
4
5
6
7
8
9
- 第一项
    - 第一个
    - 第二个
- 第二项
    - 第一个
    - 第二个  
- 第三项  
    - 第一个 
    - 第二个
  • 第一项
    • 第一个
    • 第二个
  • 第二项
    • 第一个
    • 第二个
  • 第三项
    • 第一个
    • 第二个
1
2
3
4
5
6
1. 第一项：    
    - 第一个
    - 第二个
2. 第二项：
    - 第一个
    - 第二个
  1. 第一项：
    • 第一个
    • 第二个
  2. 第二项：
    • 第一个
    • 第二个

九.Markdown 区块

语法：

  • Markdown 区块引用是在段落开头使用 > 符号 ，然后后面紧跟一个空格符号
  • 区块是可以嵌套的，一个 > 符号是最外层，两个 > 符号是第一层嵌套，以此类推退。
1
2
> 哈哈
>> 嘿嘿

哈哈

嘿嘿

1.区块中使用列表

1
2
3
4
5
> 区块中使用列表  
> 1. 第一项
> 2. 第二项
>    - 第一个
>    - 第二个

区块中使用列表

  1. 第一项
  2. 第二项
    • 第一个
    • 第二个

2.列表中使用区块

语法：

  • 如果要在列表项目内放进区块，那么就需要在 > 前添加四个空格的缩进。

例如：

1
2
3
4
5
6
- 第一项  
    > 第一个  
    > 第二个  
- 第二项  
    > 第一个  
    > 第二个
  • 第一项

    第一个
    第二个

  • 第二项

    第一个
    第二个

十.Markdown 代码

1.一个函数或片段的代码

  • 如果是段落上的一个函数或片段的代码可以用反引号把它包起来。
    例如： 
1
`printf("Hello world!");`

printf("Hello world!");

2.代码区块

  • 代码区块使用 4 个空格或者一个制表符（Tab 键）。 (最好与上面有两行的空行)
你也可以用 ```包裹一段代码，并指定一种语言（也可以不指定）：
1
2
3
4
5
6
#include <stdio.h>
int main()
{
    printf("Hello world!");
    return 0;
}

十一.Markdown 链接

语法： 

1
2
3
[链接名称](链接地址)  
 或者  
 <链接地址>

例如：

高级链接

语法： 

1
2
3
4
链接也可以用变量来代替，文档末尾附带变量地址：
[第一][第二]
然后在文档的结尾为变量赋值（网址）  
[第二]：网址

例如： 

1
2
3
[baidu][1]   //这里的数字可以用汉字代替
  
[1]:https://www.baidu.com/

baidu

十二.Markdown 图片

语法：

  • 开头一个感叹号 !

接着一个方括号，里面放上图片的替代文字

接着一个普通括号，里面放上图片的网址，最后还可以用引号包住并加上选择性的 ‘title’ 属性的文字。

例如： 

1
![向日葵](https://timgsa.baidu.com/timg?image&quality=80&size=b9999_10000&sec=1573787844528&di=24aaf71c175abe46a9deb373e29388aa&imgtype=0&src=http%3A%2F%2Fb.hiphotos.baidu.com%2Fimage%2Fpic%2Fitem%2F908fa0ec08fa513db777cf78376d55fbb3fbd9b3.jpg)

向日葵

  • 也可以像网址那样对图片网址使用变量

例如： 

1
2
3
[夜景][汉字] 
  
[汉字]:https://timgsa.baidu.com/timg?image&quality=80&size=b9999_10000&sec=1573787844527&di=f5983076e169208a621cb5ce161c5b03&imgtype=0&src=http%3A%2F%2Fb.hiphotos.baidu.com%2Fimage%2Fpic%2Fitem%2F0eb30f2442a7d9337119f7dba74bd11372f001e0.jpg

夜景

十三.表格

  • Markdown 制作表格使用 | 来分隔不同的单元格，使用 - 来分隔表头和其他行。

例如：

1
2
3
4
5
6
7
8
9
|  表头   | 表头  |
|  ----  | ----  |
| 单元格  | 单元格 |
| 单元格  | 单元格 |  

header 1 | header 2
---|---
row 1 col 1 | row 1 col 2
row 2 col 1 | row 2 col 2
表头 表头
单元格 单元格
单元格 单元格
header 1 header 2
row 1 col 1 row 1 col 2
row 2 col 1 row 2 col 2
  • 对齐方式

我们可以设置表格的对齐方式：
-: 设置内容和标题栏居右对齐。
:- 设置内容和标题栏居左对齐。
:-: 设置内容和标题栏居中对齐。

1
2
3
4
 | 左对齐 | 右对齐 | 居中对齐 |
| :-----| ----: | :----: |
| ha    |    ha |     ha |
| 单元格 | 单元格 | 单元格 |
左对齐 右对齐 居中对齐
ha ha ha
单元格 单元格 单元格

十四.Markdown一些其他基础

1.支持的 HTML 元素

不在 Markdown 涵盖范围之内的标签，都可以直接在文档里面用 HTML 撰写。
目前支持的 HTML 元素有：<kbd> <b> <i> <em> <sup> <sub> <br>等 
如：  
使用 <kbd>Ctrl</kbd>+<kbd>Alt</kbd>+<kbd>Del</kbd> 重启电脑

2.转义

Markdown 使用了很多特殊符号来表示特定的意义，如果需要显示特定的符号则需要使用转义字符，Markdown 使用反斜杠转义特殊字符：    
1
2
**文本加粗** 
\*\* 正常显示星号 \*\*

文本加粗

** 正常显示星号 ** 

1
2
3
4
5
6
7
8
9
10
11
12
13
还有这些字符可以转义：  
\   反斜线
`   反引号
*   星号
_   下划线
{}  花括号
[]  方括号
()  小括号
#   井字号
+   加号
-   减号
.   英文句点
!   感叹号

3.公式

语法：

  • 当你需要在编辑器中插入数学公式时，可以使用两个美元符 $$ 包裹 TeX 或 LaTeX 格式的数学公式来实现。提交后，问答和文章页会根据需要加载 Mathjax 对数学公式进行渲染。 
1
2
3
4
5
6
7
8
$$
\mathbf{V}_1 \times \mathbf{V}_2 =  \begin{vmatrix} 
\mathbf{i} & \mathbf{j} & \mathbf{k} \\
\frac{\partial X}{\partial u} &  \frac{\partial Y}{\partial u} & 0 \\
\frac{\partial X}{\partial v} &  \frac{\partial Y}{\partial v} & 0 \\
\end{vmatrix}
$$tep1}{\style{visibility:hidden}{(x+1)(x+1)}}
$$


-------------本文结束感谢您的阅读-------------



本文作者： heathhou
本文链接： http://heathhou.github.io/2020/03/21/Markdown%E5%9F%BA%E7%A1%80%E6%95%99%E7%A8%8B/
版权声明： 本作品采用 知识共享署名-非商业性使用-相同方式共享 4.0 国际许可协议 进行许可。转载请注明出处！
知识共享许可协议
赏

意思意思呗

支付宝
微信
置顶

扫一扫，分享到微信

微信分享二维码
本站总访问次数：次 | 本站访客人数:人

tag:

    缺失模块。
    1、请确保node版本大于6.2
    2、在博客根目录（注意不是yilia根目录）执行以下命令：
    npm i hexo-generator-json-content --save

    3、在根目录_config.yml里添加配置： 

      jsonContent:
    meta: false
    pages: false
    posts:
      title: true
      date: true
      path: true
      text: false
      raw: false
      content: false
      slug: false
      updated: false
      comments: false
      link: false
      permalink: false
      excerpt: false
      categories: false
      tags: true

一名 蚌埠学院 计算机学院 计算机科学与技术专业的 普通学生