Markdown 基础教程 (最全)

Markdown 是一种轻量级标记语言,易读易写,被广泛使用于撰写帮助文档

基础语法


标题

使用 # 号可表示 1~6 级标题

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

效果如下:

一级标题

二级标题

三级标题

四级标题

五级标题
六级标题

段落样式

字体

可以使用斜体、粗体和粗斜体三种字体,使用 *_ 包裹即可

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

效果如下:
斜体文本
粗体文本
粗斜体文本

分隔线

使用三个或以上的*-_来建立分隔线,其中可以插入空格。

_ _ _
---
***

效果如下:




下划线和删除线

文字两端加上 <u> 标签是下划线,加上两个波浪线 ~~ 则是删除线

<u>下划线</u>  // 简书不支持这种写法
~~删除线~~

效果如下:
<u>下划线</u>
删除线

脚注
这是一段内容内容 [^A]。
[^A]: 这是脚注!!!
脚注效果图

列表

Markdown支持 有序列表无序列表 两种形式:

  • 无序列表使用 *+- 标识
  • 有序列表使用 数字. 标识
// 标识和内容之间需要空格隔开
* 第一项
* 第二项
* 第三项

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

效果如下:

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

区块引用

区块引用是在段落开头使用 > 符号

> 区块内容

// 区块嵌套
> 第一层
> > 第二层
> > > 第三层

// 列表中使用区块,需要在 > 前添加四个空格的缩进
* 第一项
> 区块内容  // 无空格
* 第二项 
    > 区块内容

效果如下:

区块内容

第一层

第二层

第三层

  • 第一项

区块内容

  • 第二项

    区块内容


代码

段落上的一个函数或片段的代码可以用两个反引号 ` 把它包起来,代码区块使用 4 个空格 或者用上下三个反引号 ` 包裹起来
注:反引号在英文模式下点击键盘esc键下方第一个键即可打出

// 两个反引号
`printf()` 函数

// 上下三个反引号,反引号之间没有空格
` ` `
要展示的内容
` ` `

效果如下:
printf() 函数

要展示的内容

链接或图片

插入链接和图片比较简单,使用方法如下
注:通过img标签可以调节图片高度与宽度,但简书不支持这种方式

[百度](http://www.baidu.com)

<http://www.baidu.com>

![图片名称](https://upload-images.jianshu.io/upload_images/19619388-cc64bb07d2469bda.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)

效果如下:
百度

http://www.baidu.com

图片名称

表格

制作表格使用 | 来分隔不同的单元格,使用 - 来分隔表头和其他行,还可以通过 : 设置表格的对齐方式:

  • -: 冒号在右边设置内容和标题栏居右对齐
  • :- 冒号在左边设置内容和标题栏居左对齐
  • :-:冒号在两边设置内容和标题栏居中对齐
| 左对齐 | 右对齐 | 中对齐 |
| :----- | ----: | :---: |
| 单元格 | 单元格 | 单元格 |
| 单元格 | 单元格 | 单元格 |

效果如下:

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

高级技巧

HTML标签

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

目前支持的 HTML 元素有:<kbd> <b> <i> <em> <sup> <sub> <br>等 

但简书只支持部分标签

转义

Markdown 使用了很多特殊符号来表示特定的意义,如果需要显示特定的符号则需要使用转义字符 \

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

效果如下:
文本加粗
** 正常显示星号 **

公式

Markdown 使用 KaTeX 或者 MathJax 来渲染数学表达式,默认下的分隔符:

  • $...$ 或者 \(...\) 中的数学表达式将会在行内显示
  • $$...$$ 或者 \[...\] 或者 ```math 中的数学表达式将会在块内显示
$$
\begin{Bmatrix}
   a & b \\
   c & d
\end{Bmatrix}
$$
$$
\begin{CD}
   A @>a>> B \\
@VbVV @AAcA \\
   C @= D
\end{CD}
$$

效果如下:
\begin{Bmatrix} a & b \\ c & d \end{Bmatrix}
\begin{CD} A @>a>> B \\ @VbVV @AAcA \\ C @= D \end{CD}


文字上色

Markdown 并不支持文字颜色改变,目前可以采取折中的方法,将编辑完成的文档导出为html,然后在需要上色的部分手动添加标签<font color='#ff0000'></font>

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 211,743评论 6 492
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 90,296评论 3 385
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 157,285评论 0 348
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 56,485评论 1 283
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 65,581评论 6 386
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 49,821评论 1 290
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 38,960评论 3 408
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 37,719评论 0 266
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 44,186评论 1 303
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 36,516评论 2 327
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 38,650评论 1 340
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 34,329评论 4 330
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 39,936评论 3 313
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,757评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,991评论 1 266
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 46,370评论 2 360
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 43,527评论 2 349

推荐阅读更多精彩内容