1. Markdown 前提说明
使用工具 Visual Studio Code
使用的插件:
1. Markdown All in One 这个辅助Markdown写作的。
2. Markdown PDF 这个可以把Markdown渲染成PDF,这样你可以发给不会 使用Markdown的人阅读。
3. Paste Image 这个允许你直接将图片粘贴到Markdown文件。
4. Code Spell Checker 这个是拼写检查,帮你找错别字的,这个是支持英文,需要中文的话可以使用Spell Right,不过不知为啥在某些电脑上不能用。
5. LimfxCodeEx 这个允许你快速的发表你写的文章,是改变你写作人生的一个神器。
2. Markdown 快捷键
名称 | Markdown 符号 | 快捷键 |
---|---|---|
标题 | 用#号表示,#一级标题,##表示二级标题,依次类推 | ctrl+1、2、3、4… |
字体加粗 | 左右用**包裹起来 | ctrl+b |
斜体字 | 左右用*包裹起来 | ctrl+i |
加粗加斜体 | 左右用***包裹起来 | ctrl+i,ctrl+b,先后顺序无所谓 |
引用 | 在文字开头添加 > 表示引用说明 | ctrl+q |
时间戳 | / | ctrl+t |
代码块 | 可以通过tab或者4个空格缩进表示,也可以通过“`将代码包裹起来表示代码块 | ctrl+k |
下划线 | 用—表示下划线 | / |
有序列表 | 通过-加一个空格表示,后面跟内容 | ctrl+u |
无序列表 | 通过数字加一个.以及一个空格表示,后面跟内容 | ctrl+shift+o |
表格 | —表示,中间用竖线分割开 | / |
链接 | / | ctrl+l |
图片 | / | ctrl+g |
生成目录 |
[TOC] 表示,特殊,比如 CSDN 个blog就支持该语法 |
/ |
markdown 注释 | <!--注释的文字--> |
Alt + Shift + A |
公式符号 | $$ |
ctrl+m*2 |
3. Markdown 注释
markdown 写注释的方式
快捷键:Alt + Shift + A
使用方法如下:
<!--需要注释的文字写在此处-->
显示效果如下:
(其实下面我写了一段加了注释符号的文字,注释实际不会显示出来)
4. Markdown 标题
4.1 使用 # 号标记
使用 # 号可表示 1-6 级标题,一级标题对应一个 # 号,二级标题对应两个 # 号,以此类推。
使用方法如下:
# 1级标题
## 2级标题
### 3级标题
#### 4级标题
##### 5级标题
###### 6级标题
显示效果如下:
4.2 使用 = 和 - 标记一级和二级标题
使用方法如下:
1级标题
======
2级标题
------
显示效果如下:
5. Markdown 段落及格式
5.1 段落
第一个段落(不隔行段落:第一段后面 2个以上的空格+回车)
第二个段落
第1个段落(隔行段落:第一段后面 2个回车)
第2个段落
5.2 字体的粗体/斜体
使用方法如下:
*斜体文本*
_斜体文本_
**粗体文本**
__粗体文本__
***粗斜体文本***
___粗斜体文本___
显示效果如下:
斜体文本
斜体文本
粗体文本
粗体文本
粗斜体文本
粗斜体文本
5.3 删除线
如果段落上的文字要添加删除线,只需要在文字的两端加上两个波浪线 ~~ 即可
使用方法如下:
~~RUNOOB.COM~~
~~GOOGLE.COM~~
~~BAIDU.COM~~
显示效果如下:
RUNOOB.COM
GOOGLE.COM
BAIDU.COM
5.4 下划线
下划线可以通过 HTML 的 u 标签来实现
使用方法如下:
<u>带下划线文本</u>
显示效果如下:
<u>带下划线文本</u>
5.5 脚注
脚注是对文本的补充说明。
使用方法如下:
格式:[^要注明的文本]
例如:
创建脚注格式类似这样 [^Markdown]
[^Markdown]:学的不仅是技术,更是梦想!!!
显示效果如下:
创建脚注格式类似这样 [1]
5.6 分隔线
你可以在一行中用三个以上的星号、减号、底线来建立一个分隔线,行内不能有其他东西。
你也可以在星号或是减号中间插入空格
使用方法如下:
***
* * *
****
- - -
----------
显示效果如下:
6. Markdown 列表
Markdown 支持有序列表和无序列表。
6.1 无序列表
无序列表使用星号(*)、加号(+)或是减号(-)作为列表标记,
这些标记后面要添加一个空格,然后再填写内容
使用方法如下:
* 第一项
* 第二项
* 第三项
+ 第一项
+ 第二项
+ 第三项
- 第一项
- 第二项
- 第三项
显示效果如下:
- 第一项
- 第二项
- 第三项
- 第一项
- 第二项
- 第三项
- 第一项
- 第二项
- 第三项
6.2 有序列表
有序列表使用数字并加上 . 号来表示
- 第一项
- 第二项
- 第三项
6.3 列表嵌套
列表嵌套只需在子列表中的选项前面添加四个空格即可:
- 第一项:
- 第一项嵌套的第一个元素
- 第一项嵌套的第二个元素
- 第二项:
- 第二项嵌套的第一个元素
- 第二项嵌套的第二个元素
7. Markdown 区块
7.1 单层区块
- Markdown 区块引用是在段落开头使用 > 符号 ,然后后面紧跟一个空格符号:
使用方法如下:
> 区块引用
> Markdown教程
> 学的不仅是技术更是梦想
显示效果如下:
区块引用
Markdown教程
学的不仅是技术更是梦想
7.2 区块与区块的嵌套
- 另外区块是可以嵌套的,一个 > 符号是最外层,两个 > 符号是第一层嵌套,以此类推:
使用方法如下:
> 最外层
> > 第一层嵌套
> > > 第二层嵌套
显示效果如下:
最外层
第一层嵌套
第二层嵌套
7.3 区块中使用列表
使用方法如下:
> 区块中使用列表
> 1. 第一项
> 2. 第二项
> + 第一项
> + 第二项
> + 第三项
显示效果如下:
区块中使用列表
- 第一项
- 第二项
- 第一项
- 第二项
- 第三项
7.4 列表中使用区块
使用方法如下:
* 第一项
> Markdown教程
> 学的不仅是技术更是梦想
* 第二项
显示效果如下:
- 第一项
Markdown教程
学的不仅是技术更是梦想 - 第二项
8. Markdown 链接
8.1 基础链接
- 链接使用格式
[链接名称](链接地址)
或者
<链接地址>
使用方法如下:
1.这是一个链接 [平台](https://www.baidu.com/)
或者
2.<https://www.baidu.com/>
显示效果如下:
- 这是一个链接 平台
或者
8.2 高级链接
我们可以通过变量来设置一个链接,变量赋值在文档末尾进行:
使用方法如下:
这个链接用 1 作为网址变量 [baidu][1]
这个链接用 baidu 作为网址变量 [Baidu][baidu]
[1]: https://www.baidu.com/
[baidu]: https://www.baidu.com/
显示结果如下:
这个链接用 1 作为网址变量 baidu
这个链接用 baidu 作为网址变量 Baidu
9. Markdown 图片
9.1 图片语法格式
![](图片地址)
![alt 属性文本](图片地址)
![alt 属性文本](图片地址 "可选标题")
- 开头一个感叹号 !
- 接着一个方括号,里面放上图片的替代文字 或者 空着
- 接着一个普通括号,里面放上图片的网址,最后还可以用引号包住并加上选择性的'title' 属性的文字。
使用方法如下:
![](https://www.baidu.com/img/PCtm_d9c8750bed0b3c7d089fa7d55720d6cf.png)
![limfx 图标](https://www.baidu.com/img/PCtm_d9c8750bed0b3c7d089fa7d55720d6cf.png)
![limfx 图标](https://www.baidu.com/img/PCtm_d9c8750bed0b3c7d089fa7d55720d6cf.png "limfx")
显示效果如下:
9.2 图片加标题或解释内容
使用方法如下:
![](https://www.baidu.com/img/PCtm_d9c8750bed0b3c7d089fa7d55720d6cf.png)
*这是limfx的头像图片*
显示效果如下:
这是一张图片
10. Markdown 表格
10.1 制作表格
使用方法如下:
| 表头1 | 表头2 |
| -------- | -------- |
| 单元格a1 | 单元格b1 |
| 单元格a1 | 单元格b2 |
显示效果如下:
表头1 | 表头2 |
---|---|
单元格a1 | 单元格b1 |
单元格a1 | 单元格b2 |
10.2 对齐方式
我们可以设置表格的对齐方式:
-: 设置内容和标题栏居右对齐。
:- 设置内容和标题栏居左对齐。
:-: 设置内容和标题栏居中对齐。
使用方法如下:
| 左对齐 | 右对齐 | 居中对齐 |
| :----- | -----: | :------: |
| 单元格 | 单元格 | 单元格 |
| 单元格 | 单元格 | 单元格 |
11. Markdown 代码
11.1 一个函数或函数片代码
- 如果是段落上的一个函数或片段的代码可以用反引号把它包起来(`)
使用方法如下:
`文本中有 print("这里一个函数")` 函数
显示效果如下:
文本中有 print("这里一个函数")
函数
11.2 代码区块
代码区块使用 4 个空格或者一个制表符(Tab 键)
使用方法如下:
```
import os
os.getcwd()
print(os.getcwd)
print("这是代码区块")
```
显示效果如下:
import os
os.getcwd()
print(os.getcwd)
print("这是代码区块")
11.3 有颜色标记的代码块
· 你也可以用 ``` (键盘tab键上面的键)包裹一段代码,并指定一种语言(也可以不指定)-以下是使用 指定 python 语言之后
使用方法如下:
```python
import os
os.getcwd()
print(os.getcwd)
print("这是代码区块")
```
显示效果如下:
import os
os.getcwd()
print(os.getcwd)
print("这是代码区块")
12. Markdown 支持的HTML
元素
不在 Markdown 涵盖范围之内的标签,都可以直接在文档里面用 HTML 撰写。
目前支持的 HTML 元素有:
<kbd> <b> <i> <em> <sup> <sub> <br> <p>
等
12.1 【<kbd>
标签】用来> 显示键盘输入的效果
使用方法:
原文字:使用 Ctrl+Alt+Del 重启电脑
加标签:使用 <kbd>Ctrl</kbd>+<kbd>Alt</kbd>+<kbd>Del</kbd> 重启电脑
显示效果:
- 原文:使用 Ctrl+Alt+Del 重启电脑
- 效果:使用 <kbd>Ctrl</kbd>+<kbd>Alt</kbd>+<kbd>Del</kbd> 重启电脑
12.2 【<b>
标签】用来> 定义粗体的文本
使用方法:
原文字:文本需要加粗
加标签:<b>文本需要加粗</b>
显示效果:
- 原文:文本需要加粗
- 效果:<b>文本需要加粗</b>
12.3 【<i>
标签】用来> 定义斜体的文本
使用方法:
原文字:这是斜体文本
加标签:<i> 这是斜体文本 </i>
显示效果:
- 原文:这是斜体文本`
- 效果::<i> 这是斜体文本 </i>
12.4 【<sup>
标签】用来> 定义上标文本
使用方法:
原文字: 这个文本包含 上标 文本
加标签:这个文本包含 <sup>上标</sup>文本。
** 显示效果:**
- 原文:这个文本包含 上标 文本
- 效果:这个文本包含 上标文本。
12.5 【<sub>
标签】用来> 定义下标文本
使用方法:
原文字:这个文本包含 下标 文本。
加标签:这个文本包含 <sub>下标</sub>文本。
显示效果:
- 原文:这个文本包含 下标 文本。
- `效果:这个文本包含 下标文本。
12.6 【<strong>
标签】用来>于强调文本
- 与
<em>
标签一样,用于强调文本,但它强调的程度更强一些。
使用方法:
原文字:定义重要的文本
加标签:<strong>定义重要的文本</strong>
显示效果:
- 原文:定义重要的文本
- 效果:<strong>定义重要的文本</strong>
12.7 【<code>
标签】用来> 定义计算机代码文本
使用方法:
原文字:以下是一个简单打印代码print("hello!")
加标签:以下是一个简单打印代码<code>print("hello!")</code>
显示效果:
原文:以下是一个简单打印代码print("hello!")
效果:以下是一个简单打印代码<code>print("hello!")</code>
12.8 【<br>
标签】用来> 文本字段换行
使用方法:
原文字:使用 br 元素(换行)在文本中(换行)换行了
加标签:使用 br 元素(换行)<br>在文本中(换行)<br>换行了
显示效果:
- 原文:使用 br 元素(换行)在文本中(换行)换行了
- 效果:使用 br 元素(换行)
在文本中(换行)
换行了
12.9 【<p>
标签】用来> 定义段落
使用方法:
原文字:这是第1个段落。这是第2个段落。这是第3个段落。
加标签:<p>这是第1个段落。</p><p>这是第2个段落。</p><p>这是第3个段落。</p>
显示效果:
- 原文:这是第1个段落。这是第2个段落。这是第3个段落。
- 效果:<p>这是第1个段落。</p><p>这是第2个段落。</p><p>这是第3个段落。</p>
13. Markdown 转义符运用
- 反斜 \ 转义符号,可以把markdown中使用的 符号原样输出
Markdown 支持以下这些符号前面加上反斜杠来帮助插入普通的符号:
\ 反斜线
` 反引号
* 星号
_ 下划线
{} 花括号
[] 方括号
() 小括号
# 井字号
+ 加号
- 减号
. 英文句点
! 感叹号
例如:星号 加粗文本 要想 星号原样输出
想要的效果:**风萧萧兮易水寒,壮士一去兮不复还。**
实际效果显示:风萧萧兮易水寒,壮士一去兮不复还。
加入反斜线:\*\*风萧萧兮易水寒,壮士一去兮不复还。\*\*
最终的效果:**风萧萧兮易水寒,壮士一去兮不复还。**
14. Markdown 公式书写
当你需要在编辑器中插入数学公式时,可以使用两个美元符 $$
包裹 TeX 或 LaTeX 格式的数学公式来实现。提交后,问答和文章页会根据需要加载 Mathjax 对数学公式进行渲染。如:
-
学的不仅是技术,更是梦想!!! ↩