markdown

概览

[toc]

[TOC]

Markdown 的目标是实现「易读易写」。
Markdown 语法的目标是:成为一种适用于网络的书写语言。

Markdown 不是想要取代HTML,甚至也没有要和它相近,它的语法种类很少,只对应HTML标记的一小部分。Markdown 的构想不是要使得 HTML 文档更容易书写。在我看来,HTML已经很容易写了。Markdown的理念是,能让文档更容易读、写和随意改。HTML 是一种发布的格式,Markdown是一种书写的格式。就这样,Markdown的格式语法只涵盖纯文本可以涵盖的范围。

不在 Markdown 涵盖范围之内的标签,都可以直接在文档里面用 HTML 撰写。不需要额外标注这是 HTML 或是 Markdown;只要直接加标签就可以了。
要制约的只有一些 HTML 区块元素――比如 <div>、<table>、<pre>、<p>等标签,必须在前后加上空行与其它内容区隔开,还要求它们的开始标签与结尾标签不能用制表符或空格来缩进。Markdown 的生成器有足够智能,不会在 HTML 区块标签外加上不必要的 <p>标签。

区块元素

段落与换行

一个 Markdown 段落是由一个或多个连续的文本行组成,它的前后要有一个以上的空行(空行的定义是显示上看起来像是空的,便会被视为空行。比方说,若某一行只包含空格和制表符,则该行也会被视为空行)。普通段落不该用空格或制表符来缩进。

我不喜欢你
我也喜欢你

我不喜欢你

标题

你可以选择性地「闭合」类atx样式的标题,这纯粹只是美观用的,若是觉得这样看起来比较舒适,你就可以在行尾加上 #,而行尾的 # 数量也不用和开头一样(行首的井字符数量决定标题的阶数):

区块引用

  • Markdown 也允许你偷懒只在整个段落的第一行最前面加上 >
  • 区块引用可以嵌套(例如:引用内的引用),只要根据层次加上不同数量的 >
  • 引用的区块内也可以使用其他的 Markdown 语法,包括标题、列表、代码区块等:

列表

  • 无序列表
    • -
    • *
    • +
  • 有序列表
  • 列表项目可以包含多个段落,每个项目下的段落都必须缩进 4 个空格或是 1 个制表符:

    必须缩进四个空格
    如果要在列表项目内放进引用,那>就需要缩进:

  • 换句话说,也就是在行首出现数字-句点-空白,要避免这样的状况,你可以在句点前面加上反斜杠。
    1986\. What a great season.

代码区块

要在Markdown中建立代码区块很简单,只要简单地缩进4个空格或是1个制表符就可以,例如,下面的输入:

分割线

- - -
*** *
++ +


区段元素

链接

行内式

要建立一个行内式的链接,只要在方块括号后面紧接着圆括号并插入网址链接即可,如果你还想要加上链接的title 文字,只要在网址后面,用双引号把 title 文字包起来即可,例如:
[mylink](http://baidu.com "hhhhhhh")
如果你是要链接到同样主机的资源,你可以使用相对路
See my [About](#代码区块) page for details.

参考式

参考式的链接是在链接文字的括号后面再接上另一个方括号,而在第二个方括号里面要填入用以辨识链接的标记:
This is [an example][id] reference-style link.
接着在文件的任意位置
[id]: http://example.com/ "Optional Title Here"
链接辨别标签可以有字母、数字、空白和标点符号,但是并不区分大小写,因此下面两个链接是一样的:

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

使用 Markdown 的参考式链接,可以让文件更像是浏览器最后产生的结果,让你可以把一些标记相关的元数据移到段落文字之外,你就可以增加链接而不让文章的阅读感觉被打断。

强调

__strong__ strong
_em_ em
**strong** strong
*em* em
但是如果你的 * 和 _ 两边都有空白的话,它们就只会被当成普通的符号。
如果要在文字前后直接插入普通的星号或底线,你可以用反斜线:

代码

如果要标记一小段行内代码,你可以用反引号把它包起来(`),例如:Use the `printf()` function.
如果要在代码区段内插入反引号,你可以用多个反引号来开启和结束代码区段:

1
``There is a literal backtick (`) here.``

图片

Markdown 使用一种和链接很相似的语法来标记图片,同样也允许两种样式: 行内式和参考式
![Alt text](/path/to/img.jpg "Optional title")
参考式的图片语法则长得像这样:

![Alt text][id]

其他

索引

1
``` [^try1]: [cy](http://xight.top)workhard

索引[^try]

自动链接

Markdown 支持以比较简短的自动链接形式来处理网址和电子邮件信箱,只要是用方括号包起来, Markdown 就会自动把它转成链接。一般网址的链接文字就和链接地址一样,例如:
<http://example.com/> http://example.com/

反斜线

Markdown 可以利用反斜杠来插入一些在语法中有其它意义的符号,例如:如果你想要用星号加在文字旁边的方式来做出强调效果(但不用 标签),你可以在星号的前面加上反斜杠:
\*literal asterisks\*
*literal asterisks*

删除线

~~del~~ del

id与class

然后可以通过
title来快速跳转到制定的位置

[^try]: cy workhard