Markdown 语法入门-CSDN博客

Markdown作为一种使用普通文本编辑器编写的标记语言，通过简单的标记语法，设置文本不同的格式。以实现 [易读易写] 的目标。

Markdown为编写HTML提供了很好的实现，并避免了伴随的复杂性和丑陋难看。Markdown的语法全由一些符号组成，语法简单易上手。

本文介绍Markdown语法入门。

一、语法介绍

##1.1 标题

###1.1.1 Setext形式类Setext形式是用底线的形式，利用 = (最高阶标题) 和 - (第二阶标题)，例如：

This is H1
===========
This is H2
-------------------
复制代码

This is H1

This is H2

注意：其中，任何数量的 = 和 - 都是等效的。

###1.1.2 Atx形式

类Atx形式是在行首插入 1 到 6个 #，对应分别为标题 1 到 6 阶，例如：

# H1 #
## H2 ##
### H3 ###
#### H4 ####
##### H5 #####
##### H6 #####
复制代码

H1

H2

H3

H4

H5

H6

通常，若为了美观用，可以在行尾加上 #，行尾的 # 不强制要求和开头一样，只有行首的字符数确定标题对应的阶数。

##1.2 区块引用Blockquotes

Markdown 标记区块引用类似email中用 > 的引用方式。在每行的前面加上 >。同样，Markdown允许只在整个段落的第一行最前加上 > 。区块引用也可以嵌套，根据不同层次加上不同数量的 > 即可。引用的区块内同样可以使用其他Markdown 语法，包括标题，列表，代码区块等。

> 区块引用...
>
> 区块引用...

> 段落只需要要在第一行加上 
整个段落即引用在区块内。

> 区块间引用
>> 区块间引用

> ### 引用其他语法
复制代码

区块引用...

区块引用...

段落只需要要在第一行加上整个段落即引用在区块内。

区块间引用

区块间引用

引用其他语法

##1.3 列表

Markdown支持有序列表和无序列表。

###1.3.1 有序列表

有序列表使用1.数字接着一个英文句点；特别注意的是在标记上使用的数字并不会影响输出结果；列表项还可以包含多个段落，每个列表下段落都必须缩进4个空格或者1个制表符；如果需要在列表项目内引用的时候，使用 > 需要缩进。例如如下语法：

1.   item 1
3.   item 2(标记上使用的数字并不会影响输出结果)
2.   item 3(标记上使用的数字并不会影响输出结果)
4.   item 4
      多段文字1
      多段文字1
      >区块引用
5.  item 5
    1.列表项目内加列表
复制代码

item 1

item 2(标记上使用的数字并不会影响输出结果)
item 3(标记上使用的数字并不会影响输出结果)
item 4 多段文字1 多段文字1

区块引用
item 5 1.列表项目内加列表

###1.3.2 无序列表

无序列表使用 *(星号)、+(加好) 以及 -(减号)作为列表标记：

- item 1
+ item 2
* item 3
  - item 3.1
    - item 3.1.1
复制代码

item 1

item 2

item 3
- item 3.1
  - item 3.1.1

1.4 代码区块

和程序相关的写作通常会用到代码区块，如果用区块引用排版就会和代码排版有差异，而我们更希望是按照原来的样子显示。Markdown 通过 ` 和 ``` 标签来把代码区块包起来。

在代码区块里， & 、<和>会自动转换成HTML试题，这样让诸如插入范例使用的HTML原始码更方便了。

 <div class="footer">
        © 2004 Foo Corporation
 </div>
复制代码

在代码区块中，一般的Markdown语法不会被转换，因此可以很容易的用Markdown语法撰写相关语法文档。

1.5 分割线

在任意一行中用三个以上的 *、-以及_来建立分割线，行内不能有除空格外的其他内容。

1.6 特殊格式

1.6.1 粗体

粗体文字设置使用 **将目标文字包含起来。

Bold

1.6.2 斜体

斜体文字设置使用 _将目标文字包含起来。

Italics

1.6.3 删除线

斜体文字设置使用 ~~ 将目标文字包含起来。

~~strikethrough~~

1.6.4 语法高亮

特定语法用如```js将设置超链接的文字包含起来。

grunt.initConfig({
  assemble: {
    options: {
      assets: 'docs/assets',
      data: 'src/data/*.{json,yml}',
      helpers: 'src/custom-helpers.js',
      partials: ['src/partials/**/*.{hbs,md}']
    },
    pages: {
      options: {
        layout: 'default.hbs'
      },
      files: {
        './': ['src/templates/pages/index.hbs']
      }
    }
  }
};
复制代码

1.7 表格

1.7.1 普通表格

表格通过 | 和 -表示。表头需要和表内容用 - 分割，各列内容用 | 分割。注意，不需要垂直对齐。

|table1|table2|
|--------|-------|
|content1|content2|
复制代码

table1	table2
content1	content2

1.7.1 特殊格式表格

在表头内容分割线结束加上 : 即表示文字靠右对齐。

|table1|table2|
|--------:|-------:|
|content1|content2|
复制代码

table1	table2
content1	content2

1.8 超链接

超链接通过 [ 超链接文字 ] 包含超链接文字内容，并在后紧跟 (URL) 超链接地址。

[Link](http://www.jianshu.com/u/7f8d85055cd1)
复制代码

当需要为超链接添加hover效果的时候，在 (URL "hoverTitle") URL后用 "" 将提示文字包含起来。

[Link](http://www.jianshu.com/u/7f8d85055cd1 "Burjal")
复制代码

1.9 Named Anchors

Named Anchors使能够在相同的页面上跳转到指定的锚点。最常用的就是跳转到每一个章节。

# Table of Contents
  * [Chapter 1](#chapter-1)
  * [Chapter 2](#chapter-2)
  * [Chapter 3](#chapter-3)
复制代码

Chapter 1
Chapter 2
Chapter 3

上述会跳转到对应如下位置：

## Chapter 1 <a id="chapter-1"></a>
Content for chapter one.

## Chapter 2 <a id="chapter-2"></a>
Content for chapter one.

## Chapter 3 <a id="chapter-3"></a>
Content for chapter one.
复制代码

1.20 图片

图片的语法和超链接的语法类似，在超链接语法前加了 ! 。

![Markdown](https://user-gold-cdn.xitu.io/2017/12/16/1605d7634bc42476?w=1240&h=239&f=png&s=20553)
复制代码

#二、简书设置默认编辑器：

简书已经支持Markdown语法编辑。设置步骤如下：

在首页找到并进入设置。

将常用编辑器设置为 Markdown 。

Markdown 语法入门分析到此就结束了~

附：

Grav SYNTAX

Markdown 语法说明 (简体中文版)

Markdown: Basics(快速入门)