Markdown基本语法总结

  markdown是一种轻量级标记语言,具有纯文本格式语法。它由John Gruber 与Aaron Swartz在2004年合作创建。其目标是让人们“使用易于阅读且易于编写的纯文本格式进行编写,可选将其转换为结构上有效的XHTML或HTML”。这种语言吸收了很多在电子邮件中已有的纯文本标记的特性。

一、标题

Markdown 支持两种标题的语法,类 Setext 和类 atx 形式。
类 Setext 形式是用底线的形式,利用 = (最高阶标题)和 - (第二阶标题)。
类 Atx 形式则是在行首插入 1 到 6 个 # ,对应到标题 1 到 6 阶。

1、用#标记

在标题开头加上1~6个#,依次代表一至六级标题。

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

显示效果如下:

一级标题

二级标题

三级标题

四级标题

五级标题
六级标题

注意:#与标题之间最好空有一格,查资料时有博主表示在Visual Studio Code中,#与标题需要空一格,才能渲染为标题,但在的markdown编辑器中,#与标题不需要空一格,就能表示标题。

2、用=和-标记

在 标题底下 加上任意个=代表一级标题,-代表二级标题。
这个用法貌似不常用,也比较难用,在我手上好像还不管用,以下纪录一次失败的尝试,不懂怎么回事。

#空一行
主标题
===
副标题
---
一级标题
=========
二级标题
----------

显示效果如下:
主标题
===
副标题


一级标题

二级标题

opps!好像并没有什么卵用...这个主和副标题怎么没变化呢,-这里明摆着显示成了分割线?
注意:一级标题/主标题前方必须留有空行!否则二级标题就默认成为了分隔线,正常效果如下:

主标题

副标题

一级标题

二级标题


既然说到分割线,这里插播一条分割线。

3、分割线

在markdown语法中,一行连用三个或者三个以上的星号,减号,或者下划线,就可以表示分割线。可以在一行用3个以上的 * - _来建立一条分割线,行内除了空格不能有其他东西。
例如:

*** 这里是分割线  
--- 这里也是分割线  
__ 这里还是分割线  

显示效果如下:




据说三条线效果是不同的,按顺序是很明显,不明显,一般。的预览效果里我看着三分割线好像也没多大差别。

二、换行

方法1:连敲2个以上空格+enter键;
方法2:利用html语法,

三、缩进/空格

由于平时中文的排版习惯,首行通常缩进两字符什么的,所以顺便也了解以下操作,在markdown里这个还稍微有点麻烦,不是敲两下空格键就搞定的。这里需要借用html方面的空格实体。
首先明确1个汉字=2个空格大小
1、一个空格大小的表示 两种用法显示效果一致。
2、两个空格大小的表示 两种用法显示效果一致。
3、不换行空格的表示   也是占一个空格的宽度大小。

四、正文字体

1、粗/斜/删除线/下划线

普通的正文不需要加任何标签,直接打字就OK。但要获得加粗、斜体、删除线等效果,需要在文字左右两侧添加相应的符号。连续两个*_表示加粗, 一个*_表示斜体,~~表示删除。
那么加粗斜体怎么表示呢?没错,就是连续三个*_

**加粗**,__加粗__  
 *斜体*,_斜体_
***加粗斜体***
~~删除~~

显示效果如下:
加粗加粗
斜体斜体
加粗斜体
删除

2、反转义符号

/(反斜杠),使其后的符号成为普通符号,不加特效。

\\ 反斜杠

\` 反引号

\* 星号

\_ 下划线

\{\} 大括号

\[\] 中括号

\(\) 小括号

\#井号

\+ 加号

\- 减号

\. 英文句号

\! 感叹号

显示效果如下:
\ 反斜线
` 反引号
* 星号
_ 底线
{ } 花括号
[ ] 方括号
( ) 括弧
# 井字号
+ 加号
- 减号
. 英文句点
! 惊叹号

3、字体、字号、颜色

指定字体类型: 我是黑体字
指定字体大小: 我是12号字
指定字体颜色:我是蓝色字 #0099ff 为颜色的16进制代码
指定字体颜色、字号、字体类型黑体

测试一下里面的显示效果:
我是黑体字
显然不行。
测试了其他md编辑器,有效显示,但这里似乎是不支持的。
这里就附上其他编辑器的效果图吧:


Markdown基本语法总结_第1张图片
字体样式

由于本地图片路径显示容易出问题,这里用了图床方便生成图片url链接,使用谷歌、新浪微博或者github仓库图床应该都OK。

五、引用

如果一段的内容是引用别人的话,在被引用的文本前加上符号>

> 一个人的命运啊,当然要靠自我奋斗,但是也要考虑到历史的进程。

显示效果如下:

一个人的命运啊,当然要靠自我奋斗,但是也要考虑到历史的进程。

Markdown 标记区块引用的方法是在行的最前面加 > ,也可以只在整个段落的第一行最前面加上 >,区块引用内部可以嵌套,只要根据层次加上不同数量的 >即可,引用的区块内也可以使用其他的 Markdown 语法,包括标题、列表、代码区块等。

>还记得一句教诲吗
> >一个人的命运啊,当然要靠自我奋斗,但是也要考虑到历史的进程。
>>>谁说不是呢

显示效果如下:

还记得一句教诲吗

一个人的命运啊,当然要靠自我奋斗,但是也要考虑到历史的进程。

谁说不是呢

再来试一波儿~~~

俄罗斯套娃1

套娃2

套娃3

套娃4

套娃5

套娃6

泥垢了!!!

六、插入代码

对于程序员来说这个功能是必不可少的,插入程序代码的方式有两种,一种是利用缩进(Tab), 另一种是利用“`”符号(一般在ESC键下方)包裹代码。
语法说明:

插入行内代码,即插入一个单词或者一句代码的情况,使用`code`这样的形式插入。代码之间分别用一个反引号包起来
插入多行代码,可以使用缩进或者 ``` code ``` 具体看示例。代码之间分别用三个反引号包起来,且两边的反引号单独占一行

效果如下:
(1)单行代码:
create database coding-girl;
(2)代码块:

function fun(){
  echo "听说你这个小白要学编程";
}
fun();

注意: 缩进式插入前方必须有空行!

七、插入图片

添加图片形式和链接相似,只需要在链接的基础上前方加一个 感叹号。

![图片alt](图片地址  "optional title")
图片alt就是显示在图片下面的文字,相当于对图片内容的解释,可以不写。
图片地址链接可以是图片的本地地址或网址。
图片optional title是图片的标题,当鼠标悬置于图片上时显示的内容。title可加可不加。

显示效果如下:


Markdown基本语法总结_第2张图片
小猪佩奇

插入本地图片只需要在基础语法的括号中填入图片的位置路径即可,支持绝对路径和相对路径。但本地图片的路径更改或丢失都会造成markdown文件调不出图,不便于分享。
插入网络图片只需要在基础语法的括号中填入图片的网络链接即可,现在已经有很多免费/收费图床和方便传图的小工具可选。

八、插入列表

(1) 无序列表
- + *这三个符号均可以。注意符号与列表内容间要留一个空格。

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

显示效果如下:

  • 列表内容
  • 列表内容
  • 列表内容
    (2)有序列表
    语法:数字加点,序号与内容间需要留空格
1. 列表内容
2. 列表内容
3. 列表内容

显示效果如下:

  1. 列表内容
  2. 列表内容
  3. 列表内容
    (3)列表嵌套
    上一级和下一级之间敲三个空格即可。注意符号之后的空格不能少,符号之前的空格也不能少。
+ 一级目录
   + 二级目录
      - 三级目录

显示效果如下

  • 一级目录
    • 二级目录
      • 三级目录

九、插入超链接

链接分两种。一种是链接到其他网上地址的,还有一种是链接到本文中的某个位置的。
两种的基本格式一样。需要添加链接的文字内容用[方括号]来括起来,后面紧跟着带有网址的圆括号,如果要加上连接的title文字,在网址后面,把 title文字放到双引号里面。

[超链接名](超链接地址 "超链接title")
title可加可不加
文字链接 [链接名称](http://链接网址)
网址链接 
实例:
[](http://jianshu.com)  
[我的主页](https://www.jianshu.com/u/aaf8afe551a4 "浅羡")

显示效果如下:
 http://jianshu.com
我的主页

十、插入公式

公式左右各加1个$表示行中公式,左对齐,左右各2个$为另起一行居中效果。
我在这里先试一下简单公式

$1+1=2$
$$1+1=2$$
$x_1^2+x_2^3=9$
$\sqrt[4]{\frac xy}$
$\begin{pmatrix}1 & 2 \\ 3 & 4\\ \end{pmatrix}$

显示效果分别为




这一块涉及到的公式符号用法比较多,后续可详细阅读以下这篇文章进行学习:
markdown公式编辑方法介绍

十一、插入绘制表格

使用到的基本符号为| -:,三个元素之间的多余空格会被忽略,不影响布局。
markdown默认表格标题栏居中对齐,内容居左对齐。
-:表示内容和标题栏居右对齐,:-表示内容和标题栏居左对齐,:-:表示内容和标题栏居中对齐。
内容和|之间的多余空格会被忽略,每行第一个|和最后一个|可以省略,-的数量至少有一个。

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

第二行分割表头和内容。
- 有一个就行,为了对齐,多加了几个
文字默认居左
-两边加:表示文字居中
-右边加:表示文字居右
注:原生的语法两边都要用 | 包起来。此处省略

显示效果如下:

表头 表头 表头
内容 内容 内容
内容 内容 内容
第一格表头 第二格表头
内容单元格 第一列第一格 内容单元格第二列第一格
内容单元格 第一列第二格 多加文字 内容单元格第二列第二格
内容单元格 第一列第三格 多加文字 内容单元格第二列第三格
内容单元格 第一列第四格 多加文字 内容单元格第二列第四格

注意,使用时发现,表格的语句上一行必须为空行,不然表格不生效。


后续想解锁更多markdown的语法,可前往以下网站进行了解:

  • markdown官方文档
  • https://markdown.tw/
  • w3cschool

你可能感兴趣的:(Markdown基本语法总结)