Markdown语法最全汇总精心整理

本文阅读 8 分钟
首页 开发运维 正文

一、Markdown简介

Markdown是一种轻量级标记语言,创始人为约翰·格鲁伯(John Gruber)。 它允许人们使用易读易写的纯文本格式编写文档,然后转换成有效的 XHTML(或者HTML)文档。这种语言吸收了很多在电子邮件中已有的纯文本标记的特性。
由于Markdown的轻量化、易读易写特性,并且对于图片,图表、数学式都有支持,许多网站都广泛使用 Markdown 来撰写帮助文档或是用于论坛上发表消息。 如 GitHub、Reddit、Diaspora、Stack Exchange、OpenStreetMap 、SourceForge、简书等,甚至还能被使用来撰写电子书。

二、Markdown基本操作

1.标题
使用#号标记,可以表示1-6级标题,随#个数递增。如:

# 这是一级标题
## 这是二级标题
### 这是三级标题
#### 这是四级标题
##### 这是五级标题
###### 这是六级标题

注:最后一个#与文字间一定要有一个空格。

显示效果:

这是一级标题

这是二级标题

这是三级标题

这是四级标题

这是五级标题
这是六级标题

2.换行
markdown换行方式有很多种

  • 直接在一句话后面敲两个空格
  • 两句话之间加一个空行
  • 如果你在编辑的时候,想让一行文字分成几段在显示的时候换行,就在中间加<br/>

此点是我想在表格里换行时get到的,也很实用,后面讲到表格我会展示。

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

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

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

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

下划线
下划线直接用html的u标签即可,不属于Markdown语法了。

示例:

**这是加粗的文字**
*这是倾斜的文字*`
***这是斜体加粗的文字***
~~这是加删除线的文字~~
<u>HTML的下划线标签一起演示</u>

效果如下:
这是加粗的文字
这是倾斜的文字`
这是斜体加粗的文字
这是加删除线的文字
HTML的下划线标签一起演示

4.分割线
markdown中分割线,能是你的文章结构更加清楚

几种分割线的写法:

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

三个或者三个以上的 - 或者 * 都可以。效果如下,可以看到,显示效果是一样的。





5.列表
无序列表
语法:
无序列表用 - + * 任何一种都可以

- 列表内容
+ 列表内容
* 列表内容

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

效果如下:

  • 列表内容
  • 列表内容
  • 列表内容

有序列表
语法:
数字加点

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

注意:序号跟内容之间要有空格

效果如下:

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

列表嵌套
上一级和下一级之间敲三个空格即可

- 一级无序列表内容
   1. 二级有序列表内容
   2. 二级有序列表内容
   3. 二级有序列表内容

效果如下:

  • 一级无序列表内容

    1. 二级有序列表内容
    2. 二级有序列表内容
    3. 二级有序列表内容

6.引用
在引用的文字前加>即可。引用也可以嵌套,如加两个>>三个>>>
n个...
貌似可以一直加下去,但没神马卵用

示例:

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

效果如下:

这是引用的内容

这是引用的内容

这是引用的内容

注:在列表中使用区块是同样的道理,这里不再赘述。

三、markdown进阶

1.markdown 插入代码
语法:
单行代码:代码之间分别用一个反引号包起来

`代码内容`

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

(```)
  代码...
  代码...
  代码...
(```)

注:为了防止转译,前后三个反引号处加了小括号,实际是没有的。这里只是用来演示,实际中去掉两边小括号即可。还有一种更简洁的模式,三个反引号也可以不写,只需要每行前面必须有4个空格

示例:

单行代码

`create database hero;`

代码块

(```)
    function fun(){
         echo "这是一句非常牛逼的代码";
    }
    fun();
(```)

或者

    function fun(){
         echo "这是一句非常牛逼的代码";
    }
    fun();

    注意这里每行前面都有4个空格

效果如下:

单行代码
create database hero;
代码块

function fun(){
     echo "这是一句非常牛逼的代码";
}
fun();

2.markdown插入链接
语法:

[超链接名](超链接地址 "超链接title")
title可加可不加

示例:

[平凡记事本](https://www.pfjsb.com)

效果如下:
平凡记事本
注:Markdown本身语法不支持链接在新页面中打开,根据自己编辑器所在的软件环境可以使用程序做扩展性处理添加,或者直接使用html标签。

3.markdown插入图片
语法:

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

图片alt就是显示在图片下面的文字,相当于对图片内容的解释。
图片title是图片的标题,当鼠标移到图片上时显示的内容。title可加可不加

示例:

![演示图片](http://www.pfjsb.com/usr/themes/spimes/images/top-banner-news-winter.jpg "欢迎到来")

效果如下:
 title=

图片引入还有一种扩展写法:
示例(编号n代表一个数字):

![演示图片][编号n]
...间隔很多内容后...
[编号n]:http://www.pfjsb.com/usr/themes/spimes/images/top-banner-news-winter.jpg

效果如下:
演示图片

4.markdown表格
每排单元格要用| 分开 表头与内容用 — 分开

语法:

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

第二行分割表头和内容。里面的-有一个就行,为了对齐,多加了几个

  • 文字默认居左
  • 两边加:表示文字居中
  • 右边加:表示文字居右
    注:原生的语法两边都要用 | 包起来。此处省略

示例:

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

效果如下:

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

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

使用<kbd>ctrl</kbd>+<kbd>alt</kbd>+<kbd>alt</kbd>重启电脑

效果如下:
使用ctrl+alt+alt重启电脑

本文来自投稿,不代表本站立场,如若转载,请注明出处:
-- 展开阅读全文 --
服务器网络线路类型(CN2\BGP\CTG Net\GIA)的分析理解与比较总结
« 上一篇 04-21
PHP实现读写Excel文件的经典Composer包phpoffice/phpspreadsheet使用详记
下一篇 » 04-23

热门文章

标签TAG