Markdown 学习


参见Markdown 官网 所说宗旨

Markdown 的目标是实现「易读易写」。

可读性,无论如何,都是最重要的。一份使用 Markdown 格式撰写的文件应该可以直接以纯文本发布,并且看起来不会像是由许多标签或是格式指令所构成。Markdown 语法受到一些既有 text-to-HTML 格式的影响,包括 Setext、atx、Textile、reStructuredText、Grutatext 和 EtText,而最大灵感来源其实是纯文本电子邮件的格式。

Markdown是一种纯文本格式的标记语言。通过简单的标记语法,它可以使普通文本内容具有一定的格式。

区块元素

标题

#来标识标题,Markdown 支持六种级别的标题,分别为一到六个#,对应html中的h1~h6

#h1 这是一级标题
##h2 这是二级标题
###h3 这是三级标题
####h4 这是四级标题
#####h5 这是五级标题
######h6 这是六级标题

h1 这是一级标题

h2 这是二级标题

h3 这是三级标题

h4 这是四级标题

h5 这是五级标题
h6 这是六级标题

区块引用

在需要被引用的区域前加>
>这段文字是引用,高亮显示

这段文字是引用,高亮显示

引用中也可以使用其他语法

使用标题

使用代码块

也可以多层引用

第一层

2

3

列表

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

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

* li1
* li2
- li3
*  li4
+ li5
  • li1
  • li2
  • li3
  • li4
  • li5

可以发现:一类连续相同的符号会归为一组

有序列表使用数字加一个点

1. li1
1. li2

  1. li1
  2. li2

在有序列表中只需在乎第一个项目的编号,根据第一个项目编号自动编号
如果有类似于数字加点但却不是为了做有序列表则1996.
如果其他语法在和列表配合使用的时候出现了问题,就缩进一次,四个空格或者一个制表符代表一次缩进。如果一次缩进没有解决问题,那就两次。

列表嵌套

上一级和下一级之间多三个空格

* a
   * a
  • a
    • a

代码区块

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

这是一个普通段落:

    这是一个代码区块
    if (a == 0) {
        a = 1;
    }

这是一个普通段落:

这是一个代码区块
if (a == 0) {
    a = 1;
}

分隔线

三个或三个以上的*,_,-都可以,行内不能有其他字符

***
---
___



区段元素

链接

Markdown 支持两种形式的链接语法: 行内式和参考式两种形式。
不管是哪一种,链接文字都是用 [方括号] 来标记

行内链接

要建立一个行内式的链接,只要在方块括号后面紧接着圆括号并插入网址链接即可,如果你还想要加上链接的 title 文字,只要在网址后面,用双引号把 title 文字包起来即可,

点击[百度](http://www.baidu.com "baidu")进行搜索

点击百度进行搜索

参考式链接

参考式的链接是在链接文字的括号后面再接上另一个方括号,而在第二个方括号里面要填入用以辨识链接的标记然后在文件的任意处,你可以把这个标记的链接内容定义出来

点击[百度][baidu]进行搜索
[baidu]:http://www.baidu.com

点击[百度][baidu]进行搜索
[baidu]:http://www.baidu.com

隐式链接标记功能让你可以省略指定链接标记,这种情形下,链接标记会视为等同于链接文字,要用隐式链接标记只要在链接文字后面加上一个空的方括号,如果你要让 "Google" 链接到 google.com,你可以简化成:

点击[google][]进行搜索
[google]:http://www.baidu.com

点击google进行搜索

链接内容定义的形式为:

  • 方括号(前面可以选择性地加上至多三个空格来缩进),里面输入链接文字
  • 接着一个冒号
  • 接着一个以上的空格或制表符
  • 接着链接的网址
  • 选择性地接着 title 内容,可以用单引号、双引号或是括弧包着

强调

Markdown 使用星号*和底线_作为标记强调字词的符号,被 * _ 包围的字词会被转成用 <em>(斜体) 标签包围,用两个 *_ 包起来的话,则会被转成 <strong>(加粗),用三个*_包起来表示斜体加粗

a
*a*
_a_
**a**
__a__

a
a
a
a
a

如果你的 * 和 _ 两边都有空白的话,它们就只会被当成普通的符号。
如果要在文字前后直接插入普通的星号或底线,你可以用反斜线:
*this text is surrounded by literal asterisks*

代码区段

Markdown 能够很轻松的插入代码块

行内代码使用一个反引号进行包裹

这是一个`行内代码`

这是一个行内代码
使用三个反引号用来包裹代码块

这是一个代码块

图片

Markdown 使用一种和链接很相似的语法来标记图片,同样也允许两种样式: 行内式和参考式。

行内式

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

参考式

![Alt text][id]
[id]: url/to/image  "Optional title attribute"
![百度](http://www.baidu.com/img/superlogo_c4d7df0a003d3db9b65e9ef0fe6da1ec.png?qua=high&where=super)

百度

详细叙述如下:

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

表格

1|2|3
----|
2|2|2

语法:

  1. |、-、:之间的多余空格会被忽略,不影响布局。
  2. 默认标题栏居中对齐,内容居左对齐。
  3. -:表示内容和标题栏居右对齐,:-表示内容和标题栏居左对齐,:-:表示内容和标题栏居中对齐。
  4. 内容和|之间的多余空格会被忽略,每行第一个|和最后一个|可以省略,-的数量至少有一个。

页面内跳转

HTML锚点跳转

在需要跳转的位置添加锚点,语法如下:

<span id="jump">跳转到的地方</span>

在需要点击跳转的位置,使用上面的id,格式类似超链接的形式:

[点击跳转](#jump)
原文地址:https://www.cnblogs.com/herberts/p/10865398.html