Markdown 基础完整学习

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 有序列表

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

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

6.3 列表嵌套

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

  1. 第一项:
    • 第一项嵌套的第一个元素
    • 第一项嵌套的第二个元素
  2. 第二项:
    • 第二项嵌套的第一个元素
    • 第二项嵌套的第二个元素

7. Markdown 区块

7.1 单层区块

  • Markdown 区块引用是在段落开头使用 > 符号 ,然后后面紧跟一个空格符号:

使用方法如下:

> 区块引用
> Markdown教程
> 学的不仅是技术更是梦想

显示效果如下:

区块引用
Markdown教程
学的不仅是技术更是梦想

7.2 区块与区块的嵌套

  • 另外区块是可以嵌套的,一个 > 符号是最外层,两个 > 符号是第一层嵌套,以此类推:

使用方法如下:

> 最外层
> > 第一层嵌套
> > > 第二层嵌套

显示效果如下:

最外层

第一层嵌套

第二层嵌套

7.3 区块中使用列表

使用方法如下:

> 区块中使用列表
> 1. 第一项
> 2. 第二项
> + 第一项
> + 第二项
> + 第三项

显示效果如下:

区块中使用列表

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

7.4 列表中使用区块

使用方法如下:

* 第一项
    > Markdown教程
    > 学的不仅是技术更是梦想
* 第二项

显示效果如下:

  • 第一项

    Markdown教程
    学的不仅是技术更是梦想

  • 第二项

8. Markdown 链接

8.1 基础链接

  • 链接使用格式
[链接名称](链接地址)

或者

<链接地址>

使用方法如下:

1.这是一个链接 [平台](https://www.baidu.com/)

或者

2.<https://www.baidu.com/>

显示效果如下:

  1. 这是一个链接 平台

或者

  1. 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")

显示效果如下:

image

limfx 图标

limfx 图标

9.2 图片加标题或解释内容

使用方法如下:

![](https://www.baidu.com/img/PCtm_d9c8750bed0b3c7d089fa7d55720d6cf.png)  
*这是limfx的头像图片*

显示效果如下:

image

这是一张图片


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 对数学公式进行渲染。如:

QQ截图20211213222717.png

  1. 学的不仅是技术,更是梦想!!!

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 158,736评论 4 362
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 67,167评论 1 291
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 108,442评论 0 243
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 43,902评论 0 204
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 52,302评论 3 287
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 40,573评论 1 216
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 31,847评论 2 312
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 30,562评论 0 197
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 34,260评论 1 241
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 30,531评论 2 245
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 32,021评论 1 258
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 28,367评论 2 253
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 33,016评论 3 235
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 26,068评论 0 8
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 26,827评论 0 194
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 35,610评论 2 274
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 35,514评论 2 269

推荐阅读更多精彩内容