Markdown 语法笔记

写在前面

​　　经过几乎一天的查找搜索，我粗略地整理了一下经常会用到的Markdown语法。其中的大部分内容来自网友大佬的博客、教程等等。发表这个笔记，一是为了自己可以有一个速查的手册，第二是测试目前简书对这些语法的支持，以便以后文章发表，同时第三也想拿出来与和我一样的初学者分享，并欢迎大佬斧正与补充。
　　我线下使用的编辑器是typora，好用不多介绍；这文放到简书上面目全非，有些地方只能用图片，有的直接就放弃了，可能简书就是要“简”吧，专治各种花里胡哨(ಡωಡ)。

目录

（看来这个不行，上图）

编辑器上是这样

1.字体

加粗

**加粗**

斜体

*斜体*

斜体加粗

***斜体加粗***

<u>下划线</u>

<u>下划线</u>

删除线

~~删除线~~

上标²

上标<sup2</sup>

下标₂

下标<sub>2</sub>

设置字体、字号、颜色

好像不支持html

<font face="STCAIYUN">华文彩云</font>

<font color=gray size=5>color=gray</font>

<font color=#0099ff size=5 face="黑体">color=#0099ff size=5 face="黑体"</font>

背景色

<table><tr><td bgcolor=#D1EEEE>背景色的设置是按照十六进制颜色值：#D1EEEE</td></tr></table>

2.样式

标题

标题有6个等级，用 # 号表示

#为一级标题 ######为六级标题

另一种形式是使用=（一级）和-（二级）三个以上

主标题

副标题

主标题
======
副标题
-----

引用

引用内容1
引用内容2

子引用内容

用>表示引用，多个>连用分级

代码(块)

``中间放代码内容

System.out.println("Hellow World");

用``````表示下面的是一段代码

注意每个```独占一行，第一个```后给出代码语言可以实现代码高亮

​```c++
#include <iostream>
int main()
{
    std::cout << "Hellow World!" << std::endl;
    return 0;
}
​```

效果：

#include <iostream>
int main()
{
    std::cout << "Hellow World!" << std::endl;
    return 0;
}

任务

- [ ] 任务1
- [ ] 任务2
  - [×] 子任务
- [ ] 任务3

列表

有序列表

使用数字加小数点标记，可以有子列表。三代可区分。

1. 有序1
2. 有序2
   1. 子有序1
   2. 子有序2

无序列表

无序列表使用星号*，加号+，减号-作为标记，加空格加内容即可。

• 列表1
• 列表2
  • 子列表

注释

()

(<!--注释内容不会在浏览器中显示-->)

字符转义

反斜线（\）用于插入在 Markdown 语法中有特殊作用的字符。

包括：

\
`
*
_
{}
[]
()
#
+
-
.
!

用法：\字符 即可

**演示** (\*\*演示\*\*)

↓对比↓

演示（**演示**）

3.插入

表格

typora有方便的表格插入及格式编辑

项目	项目1	项目2
内容	内容	内容
内容	内容	内容

表格可以自适应内容长度

|、-、:之间的多余空格会被忽略

对齐方式：

默认标题栏居中对齐，内容居左对齐。
需要自定义时-:表示内容和标题栏居右对齐，:-表示内容和标题栏居左对齐，:-:表示内容和标题栏居中对齐，-至少有一个。
每行第一个|和最后一个|可以省略。

图像

基本支持常见的图像格式

插入

[图片上传失败...(image-e34290-1550671755184)]

插入三种方式——本地图片，网络图片，把图片编进Markdown

简书自带上传图片功能，因此不多废话。

![苹果](https://img.haomeiwen.com/i16367356/bbafb43be3a9b4c4.jpg?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)

苹果

（图片来源于百度）

以下对图片的操作都无法显示，不再一一截图，但是应该都可以在编辑器上实现。

修改图片大小

方法一 使用html代码

<img src ="https://timgsa.baidu.com/timg?image&quality=80&size=b9999_10000&sec=1550479777845&di=a08531ffcf1280e835e8841e3233b17a&imgtype=0&src=http%3A%2F%2Fpic.qjimage.com%2Feast019%2Fhigh%2Feast-ep-a61-6252755.jpg" height="500px" width="500px" >

width 与 height 没有顺序要求，=数字可加单位（px-像素，cm-厘米，mm-毫米）。

width和height只写其中一个按原图比例修改另一个。
效果：
（此处应有图片）

方法二 使用支持图片大小更改操作的 Mou 编辑器
使用如下语法
[图片上传失败...(image-b5c184-1550671755184)]

试了试好像不支持，先放上面。

注意: =前有个空格，可以只写宽度。

缩放

<img src ="https://timgsa.baidu.com/timg?image&quality=80&size=b9999_10000&sec=1550479777845&di=a08531ffcf1280e835e8841e3233b17a&imgtype=0&src=http%3A%2F%2Fpic.qjimage.com%2Feast019%2Fhigh%2Feast-ep-a61-6252755.jpg" width=50%>

这个好像只能按照width，以原图比例缩放，不知道其他编辑器怎么样。
效果：
（此处应有图片）

对齐方式

一张图片

<img src ="https://timgsa.baidu.com/timg?image&quality=80&size=b9999_10000&sec=1550479777845&di=a08531ffcf1280e835e8841e3233b17a&imgtype=0&src=http%3A%2F%2Fpic.qjimage.com%2Feast019%2Fhigh%2Feast-ep-a61-6252755.jpg" width=50% align="right">

(我也没有成功。。。）

图片组

<div align="center">
<img src="https://timgsa.baidu.com/timg?image&quality=80&size=b9999_10000&sec=1550479777845&di=a08531ffcf1280e835e8841e3233b17a&imgtype=0&src=http%3A%2F%2Fpic.qjimage.com%2Feast019%2Fhigh%2Feast-ep-a61-6252755.jpg" width="15%" >
<img src="https://timgsa.baidu.com/timg?image&quality=80&size=b9999_10000&sec=1550479777845&di=a08531ffcf1280e835e8841e3233b17a&imgtype=0&src=http%3A%2F%2Fpic.qjimage.com%2Feast019%2Fhigh%2Feast-ep-a61-6252755.jpg" width="15%" >
</div>

效果：
（此处应有图片）

超链接

行内式

[**简书-创作你的创作**](https://www.jianshu.com/)

简书-创作你的创作

包含'title'的链接

[**简书-创作你的创作**](https://www.jianshu.com/ "简书官网")

简书-创作你的创作

也可以用于链接本地文件

参考式

分为两部分

[链接文字][识别符]
[识别符]:URL "title"

第一行定义链接，第二行定义链接内容。识别符可以不写，用链接文本代替，URL可以使用<>括起来，title可以用"" ''()包括。链接内容的定义可以放在文档的任意地方，因此，参考式可以多次引用同一个链接，避免频繁定义。

简书

链接的自动转换

使用<>括起来的URL或者邮箱地址会自动转换为超链接

<https://www.jianshu.com/>

https://www.jianshu.com/

<123456789@email.com>

123456789@email.com

该方式适合行内较短的链接，会使用 URL 作为链接文字。邮箱地址会自动编码，以逃避抓取机器人。

水平线

可以在一行中使用三个或更多的 *、- 或 _ 来添加分隔线（<hr>）

***
-------
_____

---

字符之间可以有空格但不能有其他字符。

脚注^[1]

一般用法：

文字[^脚注id]文字
[^脚注id]:脚注内容。

注意：

脚注id请保持唯一性，引用和内容的id需要一一对应

如果只有底部脚注正文而文章中没有引用，此条脚注将被隐藏
如果只有文中引用没有底部对应脚注，一条新的脚注将添加到脚注列表末尾，且以引用标记的脚注id为内容
引用标记的脚注id，支持数字字母和空格
脚注内容支持 titile 属性，但 title 加在引用标记上

目录

[TOC]

效果就是本篇目录

4.段落

这个可能因为编辑器不同而有不一样的方法。

一个段文本如果前后一行都是空行（没有字符，或只有空格和制表符），那么它是一个段落。

换行

有时后需要另起一行而不是新加一段。

typora貌似可以shift+enter换行
后面的内容

也可以加<br>
后面的内容

可以在前一行的末尾加入至少两个空格
然后换行写其它的文字

缩进

使用特殊的占位符

【1】 &ensp;或&#8194; //半角空格
【2】 &emsp;或&#8195; //全角空格
【3】 &nbsp;或&#160; //半角的不断行的空白格

从&到;一个字符都不能少

 段落1【1】

 段落2【2】

 段落3【3】

对照段落

全角的状态下双击两次空格

切换到全角模式下输入两个空格就行了。搜狗输入法需要右键打开，或者在属性设置->高级->快捷键中开启全半角切换快捷键（shift+空格）

对齐

Markdown基本不支持排版。
可以使用html语言实现（可能有不同版本，简书不支持）

<center>居中</center>
<p align="left">居左</p>
<p align="right">居右</p>

---

1. 脚注不是标准Markdown的内容。可能会有不同的定义方式。 ↩