没有合适的资源?快使用搜索试试~ 我知道了~
1. 概述 2. 区块元素 3. 区段元素
资源详情
资源评论
资源推荐
Markdown 语法全部由一些符号组成,其作用往往一目了然。其理念是:让文档更容易读写和修改。
通常 Markdown 是一种书写格式,而 HTML 是一种发布格式。
Markdown 涵盖范围之内的标签都可以在文档中用 HTML 撰写,无需额外标注这是HTML还是 Markdown ,只需要直接加标签即
可, Markdown 生成器会自动识别出这些 HTML 标签。
HTML 区块标签(如 <div> , <p> 等)之间的 Markdown 格式语法将不会被处理。
HTML 行内标签(如 <span> , <cite> , <del> 等)之间的 Markdown 格式语法是有效的,会被处理。
HTML 行内标签(如 <span> , <cite> , <del> 等)可以在 Markdown 的段落,列表或者标题内随意使用。
根据个人习惯,你可以不使用 Markdown 格式,而完全采用 HTML 标签来格式化。
在 HTML 中, < 用于起始标签; > 用于结束标签; & 用于标记 HTML 实体。如果你想显示这几个字符,必须用其实体形式: <
–> < ; > –> > ; & –> & 。
在 HTML 中, < , > , & 的显示形式有 Markdown 生成器自动处理。
如果 & 是组成HTML实体的字符的一部分,则它按照HTML实体解析。如 © 解析为 ©。
如果 & 不是组成HTML实体的字符的一部分,则它转换成 & 。如 AT&T 解析为 AT&T 。
< 和 > 依此类推。若将其作为 HTML 标签的定界符,则 Markdown 不做任何转换;否则就自动转换为 < , > 。
如果在 Markdown 的 code 元素作用范围内,则 < , > , & 一定会被转成 < , > 和 & 。
一个 Markdown 段落是由一个或者多个连续的文本行组成,在其前后要有一个以上的空行(若它的前/后元素为其他区块元素也可以,但两个段
落之间必须有空行或者其他区块元素)。
空行的定义是:显示上看起来像是空的,比如某一行只包含了空格或者制表符,则即可视为空行。
普通段落不能用制表符来缩进
若用制表符缩进,则 Markdown 生成器将其解析为 code 元素。
普通段落不能用空格缩进
若用空格缩进,则在 HTML 输出中没有效果。类似于 HTML ,在 Markdown 中多个空白符只会显示一个空格;若想显示多个空
格,参考 HTML 。且4个空格会被 Markdown 生成器将其解析为 code 元素
Markdown 允许段落内插入换行符,然而这并不会在生成的 HTML 输出中插入 <br/> 标签。要想显示出换行,则有两个方法:
在插入处先按两个以上的空格,然后回车键;而不要直接按回车键
直接在需要换行的地方输入 <br/> 标签
Markdown 支持两种标题语法:
标题的前后不需要有空行
类Setext形式:底线式。用 = (最高阶), - (第二阶)。其中 = 或者 - 的数量至少是一个以上即可。用法为:
为了美观你可以将 = 或 - 数量延长覆盖标题的所有内容
This is H1
==========
以及
1. 概述概述
2. 区块元素区块元素
2.1 段落段落
2.2 标题标题
This is H2
----------
类Atx形式:在行首插入1到6个#,对应标题1~6阶。
你可以在行尾加上 # 来闭合Atx形式的标题,纯粹是为了美观。行尾的 # 数量不限。
通常建议 # 和文字之间保留空隔,这是标准用法(某些编辑器只支持标准用法)
# This is H1
## This is H2
### This is H3
#### This is H4
##### This is H5
###### This is H6
Markdown 区块引用使用类似email中的 > ,看起来像是你首先断好行,然后在每行的行首添加 > 。
>This is P1 line1
>, This is P1 line2
>
>This is P2 line1
>, This is P2 line2
区块引用的前后并不需要有空行。但是有时为为了结束区块引用,需要后置一个空行。
你可以只在段落的第一行最前面加上 > ,然后并不需要在该段落后面每一行前面加上 > 。
>This is P1 line1
, This is P1 line2
>
>This is P2 line1
, This is P2 line2
两段引用之间必须用空行分段,若无空行则视为一段。其中空行可以添加 > ,也可以不加 > 。
区块引用可以嵌套(如引用的引用),只需要根据层次加上不同数量的 > 。内层引用是区块元素,自动占用新的段落。
必须用空行中断内层区块引用,原因见第一条。
>This is Outer line1
>
>> This is Inner line2
>
>This is Outer line3
区块引用内也可以使用其他的 Markdown 元素,包括标题、列表、代码区块等。
>## This is H2
>
>1. This is list item1
>2. This is list item2
>
> This is code(3 Tab or 8 Backspace)
Markdown 中的列表分为有序列表和无序列表。
列表作为一个区块,其前后和后面必须有空行。
无序列表用星号 * ,加号 + 或者减号 - 作为列表标记,标记与内容之间至少一个空格。
2.3 区块引用区块引用
2.4 列表列表
* Red
* Green
* Blue
对于 + 和 - 形式的无序列表,只需要替换掉 * 即可。
有序列表用数字接着一个英文句点作为标记,标记和内容之间至少一个空格。数字的大小不影响输出的HTML效果。
通常建议数字按照1,2,3…等给出,方便阅读 Markdown 源文件。
1. Red
2. Green
3. Blue
列表中的每一项的内容可以缩进对齐,也可以不对齐。
对齐
* item1_line1 is here
and this is item1_line2
不对齐
* item1_line1 is here
and this is item1_line2.
列表项之间可以用空行分隔,在输出HTML时, Markdown 会将项目内容用 <p> 包围起来。
* Red
* Green
* Blue
的输出 HTML 为
<ul>
<li><p>Red</p></li>
<li><p>Green</p></li>
<li>Blue</li>
</ul>
列表项目可以包含多个段落,每个项目下的段落可以最多缩进4个空格或者1个制表符。其中每个段落中的行可以缩进也可以不缩进。
项目中的段落前后不必添加空行
缩进仅仅是为了阅读 Markdown 源码方便
* this is item1 p1 line1
and line2.
this is item1 p2 line1
and line2
* this is item2 p1 line1
and line2
this is item2 p2 line1
and line2
列表项目可以包含引用区块,此时 > 需要缩进4个空格或者1个制表符。
若没有缩进,则该引用对应的不是该列表项目。
* this is item1
> item1 quote1
>
> item1 quote2
列表项目可以包含代码区块,此时代码区块必须比该列表项多缩进8个空格或者2个制表符。
2.4.1 列表项列表项
若仅仅缩进4个空格或者1个制表符,则 Markdown 生成器认为这是列表项下的段落。
* item 1
code line1
code line2
Markdown 会将以数字加英文点号开头的段落解析为列表,因此对于 1986. The year is .... 这种段落,必须通过 \ 转
义: 1986\. The year is ... 。
在 Markdown 中,简单的缩进4个空格或者1个制表符会生成代码区块。它的 HTML 输出是用 <pre> 和 <code> 包围起来的区块。
代码区块的前后必须要有空行
代码区块会持续到没有缩进的那一行或者下一个区块的开始或者文件结尾。
代码区块中的 & , < , > 会自动转成 HTML 实体而不是作为 HTML 标记。
代码区块中的 Markdown 语法不会被解析。
代码区块还有一种语法:在代码的两侧均添加三个反引号 ``` 。最好在代码段的首行之前的一行以及代码段的尾行之后的一行添加三个反引
号,如:
```
code line 1
code line 2
```
你可以在一行中用三个以上的星号 * ,或者减号 - 或者底线 _ 来建立一个分隔线,行内不能有其他东西。
前后不必有空行,除了减号前面必须有空行。这是为了防止出现将作为分隔线的减号 - 解析为二阶标题。
你可以在星号 * 或者减号 - 或者底线 _ 之间插入空格
Markdown 支持两种形式的链接语法:行内式和参考式。通常参考式的链接更易于阅读 Markdown 源码。
行内式的语法为: [The text of link](http://example.net/ "Title") inline link , 输出 HTML
为 <p><a href="http://example.net/" title="Title">The text of link</a> inline link</p>
]( 之间必须没有空隙,否则 Markdown 生成器无法正确解析
title属性用双引号或单引号括起来
若url为同主机的资源,则可以用相对路径 [About](/about)
参考式的语法为: This is [The text of link][link-id] reference-style link
[link-id] 为链接标记,名字由你指定,由字母、数字、空白和标点符号组成,但并不区分大小写
][ 之间最多可以有一个空格,否则 Markdown 生成器无法正确解析
然后在文件的任意地方,你可以将这个标记 link-id 的链接内容定义出来。定义语法
为: [link-id]: http//example.com/ "Optinal title here"
链接内容定义必须在某一行的起始处,或者左侧最多可以有3个空格。若有4个空格则解析为代码区块。
]: 之间必须没有空格,否则 Markdown 生成器无法正确解析
title左侧必须有空格,否则就成为了url的一部分
title内容可以用双引号或单引号或圆括号等包围
url与 : 之间可以没有空隔,也可以有空隔
tile属性可以放到下一行,也可以增加一些缩进。因为 Markdown 中段落中的换行符并不影响 HTML 输出
2.5 代码区块代码区块
2.6 分隔线分隔线
3. 区段元素区段元素
3.1 链接链接
参考式还有一种隐式链接标记:当省略链接标记时,默认链接标记等于链接文字。如 This is [Google][] website 等价
于 This is [Google][Google] website 。
Markdown 用星号 * 和底线 _ 作为标记强调的符号。
被星号 * 或者底线 - 包围的文字,在 HTML 中会被 <em> 标签包围。如: *em text* , _em text_ 。
被两个星号 * 或两个底线 _ 包围的文字,在 HTML 中会被 <strong> 标签包围。如: **strong text** , __strong text__ 。
被三个星号 * 或三个底线 _ 包围的文字,在 HTML 中会被 <strong><em> 标签包围。
如: ***strong em text*** , ___strong em text___ 。
被四个星号 * 或四个底线 _ 包围的文字,在 HTML 中会被 <strong><strong> 标签包围。
如: ****strong strong text**** , ____strong strong text____ 。
其中,星号 * 和底线 _ 与内容之间可以有空隔。
当想在文字某行中同时插入多个星号 * 或者同时插入多个底线 _ 时,需要用反斜线转义。如 \* insert 2 asterisks \* 。
Markdown 中,被两个或两个以上的 ~ 包围的文本或空隔会生成删除线,如 ~~~text~~~ ,其 HTML 输出为 text 。
删除线的起始 ~ 标记之后的内容必须不能以空隔开始,否则 Markdown 生成器无法正确解析
删除线的结束 ~ 标记之前的内容最好不以空隔结尾,因为这会让空隔中出现删除线,如 text 。
Markdown 的行内代码语法简单,即用反引号 ` 来包围行内代码,如 `code text` 。被包围的文字在 HTML 中会被 <code> 标签包围。
开启代码片段的反引号和结束代码片段的反引号前后可以有空隔,也可以无空隔。
代码片段内, & , < , > 等均自动转成HTML实体而不 HTML 标记。
代码片段内若出现反引号,则要注意:
若想在行内代码中插入反引号,则可以用多个反引号来开启和结束代码片段。如 ``code text``
若开启代码片段用两个反引号,结束代码片段用一个反引号,则相当于向代码中插入一个反引号。如 ``code text `
若开启代码片段用一个反引号,结束代码片段用两个反引号,则 Markdown 并不会将它解析为 <code> 标签。
若想在代码片段中插入两个反引号,则要留意开启代码片段的反引号之后,结束代码片段的反引号之前要有空隔,
如 `` `code text` `` 。
Markdown 用一种与链接相似的语法来标记图片。图片同样也允许两种样式:行内式与参考式。
行内式语法为: ![Alt text](/path/to/img.jpg "Optional title") ,其中:
![ 之间必须没有空隔, ]( 之间必须没有空格, "Optional title" 与url之间可以有空隔也可以没有空 隔。
"Optional title" 是可选的,可以没有。
title属性用双引号或单引号括起来
参考式的语法为: ![Alt text][img-id] ,其中:
![ 之间必须没有空隔, ][ 之间最多可以有一个空格
img-id 为图片参考标记,其要求和语法与链接的参考标记一样。语法
为 [img-id]: /path/to/img.ipg "Optional title" 。其中:
链接内容定义必须在某一行的起始处,或者左侧最多可以有3个空格。若有4个空格则解析为代码区块。
]: 之间必须没有空格,否则 Markdown 生成器无法正确解析
title内容可以用双引号或单引号或圆括号等包围
url与 : 之间可以没有空隔,也可以有空隔
tile属性可以放到下一行,也可以增加一些缩进。因为 Markdown 中段落中的换行符并不影响 HTML 输出
目前无法在 Markdown 中指定图片的宽高,因此如果有这个需求,则可以用 HTML 中的 <img> 标签来达到目的。
3.2 强调强调
3.3 删除线删除线
3.4 行内代码行内代码
3.5 图片图片
剩余38页未读,继续阅读
又可乐
- 粉丝: 60
- 资源: 309
上传资源 快速赚钱
- 我的内容管理 展开
- 我的资源 快来上传第一个资源
- 我的收益 登录查看自己的收益
- 我的积分 登录查看自己的积分
- 我的C币 登录后查看C币余额
- 我的收藏
- 我的下载
- 下载帮助
安全验证
文档复制为VIP权益,开通VIP直接复制
信息提交成功
评论0