Markdown Syntax
- 概述
- 哲学
- 行内HTML
- 特殊字符自动转换
- 区块元素
- 段落和换行
- 标题
- 区块引言
- 列表
- 程序代码块
- 分割线
- 区段元素
- 链接
- 强调
- 程序代码
- 图片
- 其他
- 转义字符
- 自动链接
1.概述
哲学
Markdown的目标是实现易读易写。
行内HTML
Markdown的语法有一个主要的目的:用来作为一种网络内容的写作语言。
Markdown不是用来取代HTMl的,甚至也没有必要和它相似,它的语法种类不多,HTML是一种发布的格式,而Markdown是一种编写的格式。
不在 Markdown 涵盖范围之内的标签,都可以直接在文档里面用 HTML 撰写。不需要额外标注这是 HTML 或是 Markdown;只要直接加标签就可以了。
<p>This is a paragraph</p>
<table>
<tr>
<td>**Foo**</td>
</tr>
</table>
<p>This is a paragraph</p>
<table>
<tr>
<td>Foo</td>
</tr>
</table>
2.区块元素
段落和换行
一个段落是由一个以上相连接的行句组成,而一个以上的空行则会切分出不同的段落,一般的段落不需要用空白或断行缩排。Markdown允许段落内的强迫断行,Markdown中email式的区块引言和多段落的列表 在使用换行来排版的时候,不但更好用,还更好阅读。
标题
Markdown支持两种形式的标题语法:[setext]和[atx]
Setext形式是用底线形式,例如:
This is an H1
================
This is an H2
----------------
This is an H1
This is an H2
Atx形式的是在行首插入1到6个#,对应标题1到6级,例如:
#This is an H1
##This is an H2
######This is an H6
This is an H1
This is an H2
This is an H6
区块引用
This is a blockquote with two paragraphs. Lorem ipsum dolor sit amet,
consectetuer adipiscing elit. Aliquam hendrerit mi posuere lectus.
Vestibulum enim wisi, viverra nec, fringilla in, laoreet vitae, risus.Donec sit amet nisl. Aliquam semper ipsum sit amet velit. Suspendisse
id sem consectetuer libero luctus adipiscing.
This is a blockquote with two paragraphs. Lorem ipsum dolor sit amet,
consectetuer adipiscing elit. Aliquam hendrerit mi posuere lectus.
Vestibulum enim wisi, viverra nec, fringilla in, laoreet vitae, risus.
Donec sit amet nisl. Aliquam semper ipsum sit amet velit. Suspendisse
id sem consectetuer libero luctus adipiscing.
This is the first level of quoting.
This is nested blockquote.
Back to the first level.
列表
1)无序列表:*,+,-
- Red
- Green
- Blue
2)有序列表:数字加句点
- Apple
- Orange
- Banana
-
This is a list item with two paragraphs. Lorem ipsum dolor
sit amet, consectetuer adipiscing elit. Aliquam hendrerit
mi posuere lectus.Vestibulum enim wisi, viverra nec, fringilla in, laoreet
vitae, risus. Donec sit amet nisl. Aliquam semper ipsum
sit amet velit. Suspendisse id sem consectetuer libero luctus adipiscing.
-
A list item with a code block:
print "Hello, python!",*good boy*
分割线
在一行内用三个或以上的*,-,_来建立一个分割线,行内不能有其他东西。
3.区段元素
链接
Markdown 支持两种形式的链接语法: 行内和参考两种形式。
This is an example inline link.
This link has no title attribute.
See my local page for details.
This is 百度 reference-style link.
I get 10 times more traffic from Google than from
Yahoo or MSN.
强调
Markdown使用*和_作为标记强调字词的符号,被一个符号包围的表示斜体,被两个符号包围的表示粗体。
斜体1
斜体2
粗体1
粗体2
程序代码
如果要标记一小段行内程序代码,可以用反引号把它括起来,例如:
Use the printf()
function.
print("good ` work")
图片
Markdown 使用一种和链接很相似的语法来标记图片,同样也允许两种样式: 行内 和 参考。
行内:
![img1](http://.... "title")
[图片上传失败...(image-ca7913-1533214280657)]
参考:
![img2][img2_id]
[img2_id]: http://... "title"
![img2][img2_id]
[img2_id]: https://timgsa.baidu.com/timg?image&quality=80&size=b9999_10000&sec=1533146185522&di=07c1c33708eb26e2bf4c118746ed673b&imgtype=0&src=http%3A%2F%2Fpic1.win4000.com%2Fwallpaper%2Fc%2F581bfde257b66.jpg "绽放"
4.其他
自动链接
Markdown 支持比较简短的自动链接形式来处理网址和电子邮件信箱,只要是用方括号包起来, Markdown 就会自动把它转成链接,链接的文字就和链接位置一样,例如:
自动邮件链接也类似
转义字符
Markdown 可以利用反斜杠来插入一些在语法中有其它意义的符号。
Markdown 支持在下面这些符号前面加上反斜杠来帮助插入普通的符号:
\ 反斜杠
` 反引号
* 星号
_ 底线
{} 大括号
[] 方括号
() 括号
# 井字号
+ 加号
- 减号
. 英文句点
! 惊叹号