主要分为区块元素和区段元素

区块元素

1. 段落和换行

一个 Markdown 段落是由一个或多个连续的文本行组成，它的前后要有一个以上的空行

2.标题

第一种形式是在行首插入 1 到 6 个 # ，对应到标题 1 到 6 阶，例如：

# 这是h1

## 这是h2

###### 这是h6

第二种形式是用底线的形式，利用 = （最高阶标题）和 - （第二阶标题），例如：

这是 H1
=============

这是 H2
-------------

3.区块引用

在整个段落的第一行最前面加上 > ，或者段落的每一行前面加上 >

>折戟沉沙铁未销，
>自将磨洗认前朝。
>东风不与周郎便，
>铜雀春深锁二乔。

区块引用可以嵌套（例如：引用内的引用），只要根据层次加上不同数量的 >

>每一种人生的选择，都有自己的代价与收获，人生的每一条路，无非都是一场戏，
>不同的选择经历不同的人生，看到不同的风景。没有成败，没有对错，唯有不同而已。
>>其实我们每个人都不缺梦想，特别在这个梦想都快被说烂了的年代，
>>我们所缺的，仅仅是为梦想矢志不渝的精神，
>>哪怕是一点点所谓的坚持，都显得弥足珍贵。
>>而这一切，可能我们都曾在年少时拥有过，
>>但却随着时光的流去消失在成长的激流勇进中。
>>--《当你的才华还撑不起你的梦想时》

4.列表

无序列表使用星号、加号或是减号作为列表标记：

* Red
* Green
* blue
  • Red
  • Green
  • blue

有序列表则使用数字接着一个英文句点：

1. Bird
2. McHale
3. Parish
  1. Bird
  2. McHale
  3. Parish

5.代码区块

在 Markdown 中建立代码区块很简单，只要简单地缩进 4 个空格或是 1 个制表符就可以

这是普通段落
    这是代码区块
    bla。。。

效果如下：

这是普通段落

这是代码区块
bla。。。

另：需要引用代码时，如果引用的语句只有一段，不分行，可以用 “ `“ 将语句包起来。
如果引用的语句为多行，可以将 “\```“ 置于这段代码的首行和末行。
加强代码块使用“\```“+“语言名称”进行标记

markdown加强代码块.png

6.分割线

你可以在一行中用三个以上的星号、减号、底线来建立一个分隔线，行内不能有其他东西。你也可以在星号或是减号中间插入空格。下面每种写法都可以建立分隔线：

* * *

***

*****

- - -

---------------------------------------

区段元素

1. 链接

两种方式的链接文字都是用 [方括号] 来标记

1.1 行内式

[xigua's blog](http://xianh5.com "xigua的博客")

1.2 参考式

[xigua's blog][id]
id为辨识链接的标记
在文件的任意处，你可以把这个标记的链接内容定义出来：
[id]: http://xianh5.com "xigua的博客"

xigua's blog

2. 强调

Markdown 使用星号（*）和底线（_）作为标记强调字词的符号

2.1 斜体

*斜体*

2.2 粗体

**粗体**

2.3 删除线

~~这是一行带删除线的文字~~

2.4 空格

Markdown语法会忽略首行开头的空格，可以直接采用 HTML 标记插入空格

插入一个空格
  或   或  
插入两个空格
  或   或  
插入四个空格
  或   或  
插入细空格
  或   或  

2.5 标记代码

如果要标记一小段行内代码，你可以用反引号把它包起来（\`）

Use the `printf()` function.

Use the printf() function.

3. 图片

也可使用行内式和参考式

3.1 行内式

![Alt text](/path/to/img.jpg "Optional title")

详细叙述如下：

  • 一个惊叹号 !
  • 接着一个方括号，里面放上图片的替代文字

  • 接着一个普通括号，里面放上图片的网址，最后还可以用引号包住并加上 选择性的 'title' 文字。

    3.2 参考式

    Alt text

[id]: url/to/image  "Optional title attribute"

如果你需要指定图片的宽高的话，可以使用普通的 <img> 标签。

其他

1. 反斜杠

在一些符号前面加上反斜杠来帮助插入普通的符号（有点转义的意思）

\*不使用斜体，只用星号强调\*

2. 自动链接

用方括号包起来， Markdown 就会自动把它转成链接

<http://xianh5.com>

http://xianh5.com

3. 表格

--:为右对齐。
:--为左对齐。
:--:为居中对齐。
--为使用默认居中对齐。

|userName | sex | phone |
| --: | :--: | --: |
| 韩梅梅 | 女 | 1234567890 |
| 李雷 | 男 | 1234567890 |
userNamesexphone
韩梅梅女1234567890
李雷男1234567890

参考文章

http://www.markdown.cn

版权属于：xigua

本文链接：https://www.xianh5.com/archives/8/

转载时须注明出处及本声明

最后修改：2020 年 03 月 25 日
© 允许规范转载
如果觉得我的文章对你有用，请随意赞赏或留下你的评论~