Markdown使用教程

2021-05-13  本文已影响0人  骑猪追火车

Markdown介绍

Markdown 是一种轻量级标记语言,它允许人们使用易读易写的纯文本格式编写文档。
Markdown 语言在 2004 由约翰·格鲁伯(英语:John Gruber)创建。
Markdown 编写的文档可以导出 HTML 、Word、图像、PDF、Epub 等多种格式的文档。
Markdown 编写的文档后缀为 .md, .markdown。

Markdown应用

许多网站都广泛使用 Markdown 来撰写帮助文档或是用于论坛上发表消息。例如:GitHub、简书、reddit、Diaspora、Stack Exchange、OpenStreetMap 、SourceForge等

Markdown 编辑器

Markdown常用编辑器Typora,功能强大。

Typora 官网:https://typora.io/
你也可以使用我们的在线编辑器来测试:https://c.runoob.com/front-end/712

一、Markdown 标题

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

使用方法:
一级标题展示
=======
二级标题展示
--------

效果呈现:

一级标题展示

二级标题展示

1.2、使用# 号标记

使用方法:
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题

效果呈现:

一级标题

二级标题

三级标题

四级标题

五级标题
六级标题

二、Markdown 段落

段落:使用两个以上的空格加回车。也可以使用一个空行表示

2.1、Markdown 字体

使用方法:

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

效果呈现:

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

2.2、Markdown 分割线

使用方法:
可以在一行中用三个以上的星号、减号、底线来建立一个分隔线,行内不能有其他东西。

***
* * * *
----
------------------

效果呈现:





2.3、Markdown 删除线

使用方法:
段落上的文字需要加删除线,只需要在文字两端加上两个波浪线。

假如给我~~三天~~光明

效果呈现:

假如给我三天光明

2.4、Markdown下划线

使用方法:
通过HTML的<u>实现

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

效果呈现:

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

2.5、Markdown 脚注

使用方法:
脚注是对文本的补充说明

创建脚注格式类似这样 [^baidu]。
[^baidu]: 百度一下 -- 哪里不会搜哪里!!!

效果呈现:
创建脚注格式类似这样 [1]。(脚注在文章最后)

三、Markdown 列表

3.1、无序列表

使用方法:
使用*、+、-作为标记,后面要添加一个空格,然后写内容。

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

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

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

效果呈现:

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

3.2、有序列表

使用方法:
使用数字并加上.号来表示

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

效果呈现:

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

3.3、列表嵌套

使用方法:
列表嵌套只需在子列表中的选项前添加四个空格。

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

效果呈现:

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

四、Markdown 区块

4.1、区块

使用方法:
在段落开头使用>符号,加空格。

> 这是一个区块

效果呈现:

这是一个区块

4.2、区块嵌套

使用方法:
一个>是最外层,两个>>是里面一层

>最外层
>>第二层
>>>第三层

效果呈现:

最外层

第二层

第三层

4.3、区块中使用列表

使用方法:

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

效果呈现:

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

4.4、列表中使用区块

使用方法:
需要在>前添加4个空格缩进

* 第一项
(此处4空格)> 菜鸟教程
(此处4空格)> 学的不仅是技术更是梦想
* 第二项

效果呈现:

五、Markdown 代码

5.1、代码

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

'print()' 函数

效果呈现:

这是一个代码'print()' 函数

5.2、代码区块

使用方法:
前面添加4个空格或者两个制表符。
print('hello word!')

效果呈现:

print('hello word!')

5.3、指定语言

使用方法:
也可以使用'''代码'''包裹住一段代码,并指定一种语言。
'''Python
def add(a,b):
return a+b
'''

效果呈现:

'''Python
def add(a,b):
return a+b
'''

六、Markdown 链接

6.1、链接

使用方法:

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

这是一个链接[简书](https://www.jianshu.com/)

也可以直接使用链接地址
<https://www.jianshu.com/>

效果呈现:
这是一个链接简书

https://www.jianshu.com/

6.2、高级链接

使用方法:
通过变量来设置一个链接,变量赋值在文档末尾进行。

这个链接用 1 作为网址变量 [Google][1]
然后在文档的结尾为变量赋值(网址)
[1]: http://www.google.com/

效果呈现:

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

七、Markdown 图片

7.1、使用链接

使用方法:
格式:

![alt 属性文本](图片地址)
![alt 属性文本](图片地址 "可选标题")

效果呈现:

简书图标
作者头像

7.2、使用变量

也可以像网址那样对图片使用变量
使用方法:
这个链接用 1 作为网址变量 [Google][1]
然后在文档的结尾为变量赋值(网址)

[1]: https://www.google.cn/landing/cnexp/google-search.png

效果呈现:

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

八、Markdown 表格

8.1、表格

使用方法:
使用|来分割不同的单元格,使用-来分割表头和其他行。

| 表头 | 表头 |
| ---- | ---- |
| 单元格 | 单元格 |
| 单元格 | 单元格 |

效果呈现:

表头 表头
单元格 单元格
单元格 单元格

8.2、对齐方式:

使用方法:

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

效果呈现:

左对齐 右对齐 居中对齐
单元格 单元格 单元格
单元格 单元格 单元格

九、Markdown 高级技巧

9.1、支持HTML元素

使用方法:
支持的元素有:<kbd><b><i><em><sup><br><sub>等。
使用 <kbd>Ctrl</kbd>+<kbd>Alt</kbd>+<kbd>Del</kbd> 重启电脑

效果呈现:

使用 <kbd>Ctrl</kbd>+<kbd>Alt</kbd>+<kbd>Del</kbd> 重启电脑

9.2、转义

使用方法:
使用反斜杠转义

**文本加粗**
\*\* 正常显示星号 \*\*

效果呈现:

文本加粗
** 正常显示星号 **

9.3、公式

使用方法:
需要插入数学公式时,可以使用两个美元符号$$包裹数学公式。需要进行渲染。

$$
\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)}}
$$

效果呈现:

\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)}}


  1. 百度一下 -- 哪里不会搜哪里!!!

上一篇下一篇

猜你喜欢

热点阅读