Fork me on GitHub

Markdown 基础语法

Markdown是一种可以使用普通文本编辑器编写的标记语言,通过简单的标记语法,它可以使普通文本内容具有一定的格式。它允许人们使用易读易写的纯文本格式编写文档,然后转换成格式丰富的HTML页面,Markdown文件的后缀名便是 .md, .markdown。
Markdown 应用
Markdown 能被使用来撰写电子书,如:Gitbook。
当前许多网站都广泛使用 Markdown 来撰写帮助文档或是用于论坛上发表消息。例如:博客园、GitHub、简书、reddit、Diaspora、Stack Exchange、OpenStreetMap 、SourceForge等。

一、标题

一个#是一级标题,二个#是二级标题,以此类推。支持六级标题(也就是HTML代码中的h1-h6)。也可以用两个以上的=代表一级标题,两个以上的-代表二级标题,个人觉得没有用#方便。
注:标准语法一般在#后跟个空格再写文字。

代码如下:

我展示的是一级标题
====

我展示的是二级标题
--
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题

效果如下:
我展示的是一级标题

我展示的是二级标题

一级标题

二级标题

三级标题

四级标题

五级标题
六级标题

二、段落

Markdown 段落没有特殊的格式,直接编写文字就好,在段落后面使用一个空行来表示重新开始一个段落
代码如下:

第一段文字

第二段文字

效果如下:

第一段文字

第二段文字

三、字体

  • 加粗

要加粗的文字左右分别用两个*号包起来

  • 斜体

要倾斜的文字左右分别用一个*号包起来

  • 斜体加粗

要倾斜和加粗的文字左右分别用三个*号包起来

  • 高亮

要高亮的文字左右分别用两个==号包起来

  • 删除线

要加删除线的文字左右分别用两个~~号包起来

代码如下:

**这是加粗的文字**
*这是倾斜的文字*
***这是斜体加粗的文字***
==这是高亮的文字==
~~这是加删除线的文字~~

效果如下:
这是加粗的文字
这是倾斜的文字
这是斜体加粗的文字
这是高亮的文字
这是加删除线的文字

四、引用

在引用的文字前加>即可。引用也可以嵌套,如加两个>>三个>>>
n个...

代码如下:

>这是引用的内容
>>这是引用的内容
>>>>>>>>>>这是引用的内容

效果如下:

这是引用的内容

这是引用的内容

这是引用的内容

五、分割线

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

代码如下:

***

* * *

*****

- - -

----------

效果如下:






  • 下划线

下划线可以通过 HTML 的 <u> 标签来实现:
代码如下:

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

效果如下:
带下划线文本

六、图片

语法:

![图片alt]('图片地址' '图片title')

图片alt就是如果图片地址失效时候,展示给用户对图片内容的解释。
图片title是图片的标题,当鼠标移到图片上时显示的内容。title可加可不加

代码如下:

![我的头像](https://pic.cnblogs.com/face/733258/20160909132007.png "头像")

效果如下:

我的头像

七、超链接

title可加可不加
语法:

[超链接名]('超链接地址' '超链接title')

示例:

[百度](http://baidu.com "百度链接")

效果如下:

百度

注:Markdown本身语法不支持链接在新页面中打开,个别平台做了处理,是可以的。如果想要在新页面中打开的话可以用html语言的a标签代替。

代码如下:

<a href="超链接地址" target="_blank">超链接名</a>

示例
<a href="https://www.cnblogs.com/jiaoshou/" target="_blank">博客园</a>

效果如下:

示例
博客园

八、列表

无序列表写法介绍:

无序列表用 ** ( - + * ) **任何一种都可以

代码如下:

- 第一种列表写法
+ 第二种列表写法
* 第三种列表写法

注意:- + * 跟内容之间都要有一个空格

效果如下:

  • 第一种列表写法
  • 第二种列表写法
  • 第三种列表写法

有序列表写法介绍:

有序列表用数字加点即可

代码如下:

1. 列表内容
2. 列表内容
3. 列表内容

效果如下:

1.列表内容
2.列表内容
3.列表内容

列表嵌套写法介绍:

列表嵌套只需在子列表中的选项添加四个空格即可,有序列表和无序列表写法一样:

代码如下:

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

效果如下:

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

九、表格

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

语法:

| 表头 | 表头 | 表头 |
| --- | :--: | ---: |
| 内容 | 内容 | 内容 |
| 内容 | 内容 | 内容 |

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

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

代码如下:

| 姓名 | 技能 | 排行 |
| -- | :--: | --: |
| 刘备 | 哭 | 大哥 |
| 关羽 | 打 | 二哥 |
| 张飞 | |骂 | 三弟 |

效果如下:

姓名 技能 排行
刘备 大哥
关羽 二哥
张飞 三弟

十、代码

行内代码块:代码首尾分别用一个反引号( ` )包起来即可

代码如下:

我的`代`码

效果如下:

我的

单行、多行代码块:代码之间分别用三个反引号 ( ``` )包起来,且两边的反引号单独占一行

代码如下:

(```)
一行代码
两行代码
三行代码
(```)

效果如下:

一行代码
两行代码
三行代码

注:为了防止转译,前后三个反引号处加了小括号,实际是没有的。这里只是用来演示,实际中去掉两边小括号即可。

十一、高级技巧

  • 支持的 HTML 元素
    不在 Markdown 涵盖范围之内的标签,都可以直接在文档里面用 HTML 撰写。

目前支持的 HTML 元素有:<kbd> <b> <i> <em> <sup> <sub> <br>等(但是个别平台对html这些稀有标签未做样式处理,建议减少使用此类标签)。

代码如下:

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

效果如下:

Ctrl+Alt+Del 重启电脑

注:本平台就未做样式出来,但是你可以查看元素看到效果

  • 支持流程图
    多数平台不支持显示,暂不解释,请自行百度其他文字学习。
posted @ 2019-12-08 15:26  较瘦  阅读(269)  评论(0编辑  收藏  举报
知识点文章整理