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


区块元素


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 日
如果觉得我的文章对你有用,请随意赞赏或留下你的评论~