Markdown 基础学习

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 这个允许你快速的发表你写的文章,是改变你写作人生的一个神器。


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 注释

markdown 写注释的方式

使用方法如下:

<!--需要注释的文字写在此处-->

显示效果如下:

(其实下面我写了一段加了注释符号的文字,注释实际不会显示出来)


Markdown 标题

使用 # 号标记

使用 # 号可表示 1-6 级标题,一级标题对应一个 # 号,二级标题对应两个 # 号,以此类推。

使用方法如下:

# 1级标题
## 2级标题
### 3级标题
#### 4级标题
##### 5级标题
###### 6级标题

显示效果如下:

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

使用方法如下:

1级标题
======

2级标题
------

显示效果如下:


Markdown 段落及格式

段落

第一个段落(不隔行段落:第一段后面 2个以上的空格+回车)
第二个段落

第1个段落(隔行段落:第一段后面 2个回车)

第2个段落

字体的粗体/斜体

使用方法如下:

*斜体文本*  
_斜体文本_  
**粗体文本**  
__粗体文本__  
***粗斜体文本***  
___粗斜体文本___

显示效果如下:

斜体文本
斜体文本
粗体文本
粗体文本
粗斜体文本
粗斜体文本

删除线

如果段落上的文字要添加删除线,只需要在文字的两端加上两个波浪线 ~~ 即可

使用方法如下:

~~RUNOOB.COM~~
~~GOOGLE.COM~~
~~BAIDU.COM~~

显示效果如下:

RUNOOB.COM
GOOGLE.COM
BAIDU.COM

下划线

下划线可以通过 HTML 的 u 标签来实现

使用方法如下:

<u>带下划线文本</u>

显示效果如下:

带下划线文本

脚注

脚注是对文本的补充说明。

使用方法如下:

格式:[^要注明的文本]

例如:

创建脚注格式类似这样 [^LIMFX]
[^LIMFX]:学的不仅是技术,更是梦想!!!

显示效果如下:

创建脚注格式类似这样 [1]

分隔线

你可以在一行中用三个以上的星号、减号、底线来建立一个分隔线,行内不能有其他东西。 你也可以在星号或是减号中间插入空格

使用方法如下:

***

* * *

****

- - -

----------

显示效果如下:






Markdown 列表

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

无序列表

无序列表使用星号(*)、加号(+)或是减号(-)作为列表标记, 这些标记后面要添加一个空格,然后再填写内容

使用方法如下:

* 第一项
* 第二项
* 第三项

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

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

显示效果如下:

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

有序列表

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

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

列表嵌套

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

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

Markdown 区块

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

使用方法如下:

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

显示效果如下:

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

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

使用方法如下:

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

显示效果如下:

最外层

第一层嵌套

第二层嵌套

  • 区块中使用列表

使用方法如下:

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

显示效果如下:

区块中使用列表

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

使用方法如下:

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

显示效果如下:

  • 第一项

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

  • 第二项

Markdown 链接

基础链接

链接使用格式

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

或者

<链接地址>

使用方法如下:

1.这是一个链接 [专业平台](https://www.limfx.pro/)

2.<https://www.limfx.pro/>

显示效果如下:

  1. 这是一个链接 专业平台

  2. https://www.limfx.pro/

高级链接

我们可以通过变量来设置一个链接,变量赋值在文档末尾进行:

使用方法如下:

这个链接用 1 作为网址变量 [limfx][1]
这个链接用 limfx 作为网址变量 [LimFfx][limfx]
然后在文档的结尾为变量赋值(网址)

  [1]: https://www.limfx.pro//
  [limfx]: https://www.limfx.pro/

显示结果如下:

这个链接用 1 作为网址变量 Baidu 这个链接用 limfx 作为网址变量 LimFfx 然后在文档的结尾为变量赋值(网址)


Markdown 图片

图片语法格式


![](图片地址)

![alt 属性文本](图片地址)

![alt 属性文本](图片地址 "可选标题")
  • 开头一个感叹号 !
  • 接着一个方括号,里面放上图片的替代文字 或者 空着
  • 接着一个普通括号,里面放上图片的网址,最后还可以用引号包住并加上选择性的'title' 属性的文字。

使用方法如下:

![](https://cdn.limfx.pro/img/ran/903)
![limfx 图标](https://cdn.limfx.pro/img/ran/903)
![limfx  图标](https://cdn.limfx.pro/img/ran/903 "limfx")

显示效果如下:

limfx 图标 limfx  图标

指定图片高度宽度方法

Markdown 还没有办法指定图片的高度与宽度,如果你需要的话, 你可以使用普通的 < > 标签。

使用方法如下:

<img src="https://cdn.limfx.pro/img/ran/90" width="30%">

显示效果如下:

图片加标题或解释内容

使用方法如下:

![](https://cdn.limfx.pro/img/ran/90)  
*这是limfx的头像图片*

显示效果如下:


这是limfx的头像图片


Markdown 表格

制作表格

  • 第一种方法

使用方法如下:

|  表头1   | 表头2  |
|  ----  | ----  |
| 单元格a1  | 单元格b1 |
| 单元格a1  | 单元格b2 |

显示效果如下:

表头1 表头2
单元格a1 单元格b1
单元格a1 单元格b2
  • 第2种方式

使用方法如下:

  表头1   | 表头2  
  ----  | ----  
 单元格a1  | 单元格b1 
 单元格a1  | 单元格b2 

显示效果如下:

表头1 表头2
单元格a1 单元格b1
单元格a1 单元格b2

对齐方式

我们可以设置表格的对齐方式:

-: 设置内容和标题栏居右对齐。

:- 设置内容和标题栏居左对齐。

:-: 设置内容和标题栏居中对齐。

使用方法如下:

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

Markdown 代码

一个函数或函数片代码

  • 如果是段落上的一个函数或片段的代码可以用反引号把它包起来(`)

使用方法如下:

`print("这里一个函数")` 函数

显示效果如下:

print("这里一个函数") 函数

代码区块

代码区块使用 4 个空格或者一个制表符(Tab 键)

使用方法如下:

    import os
    os.getcwd()
    print(os.getcwd)
    print("这是代码区块")

显示效果如下:

import os
os.getcwd()
print(os.getcwd)
print("这是代码区块")

有颜色标记的代码块

· 你也可以用 ``` (键盘tab键上面的键)包裹一段代码,并指定一种语言(也可以不指定)-以下是使用 指定 python 语言之后

使用方法如下:

显示效果如下:

import os
os.getcwd()
print(os.getcwd)
print("这是代码区块")

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


本文章使用limfx的vscode插件快速发布