关于

个人简介

个人详细介绍: 无

Markdown 语法快速入门

  • Markdown 是一种轻量级标记语言,能将文本换成有效的XHTML(或者HTML)文档,它的目标是实现易读易写,成为一种适用于网络的书写语言。
  • Markdown 语言简单明了,易于掌握,所以用它来写作是件既效率又舒服的事情。我们所熟知的一些大型CMS,如Joomla、Drupal等都能很好的支持Markdown。我是因为写GitHub项目库中的Readme才开始接触Markdown。
  • Markdown 不是想要取代 HTML,甚至也没有要和它相近,它的语法种类很少,只对应 HTML 标记的一小部分。
  • Markdown 的构想不是要使得 HTML 文档更容易书写。在我看来, HTML 已经很容易写了。
  • Markdown 的理念是,能让文档更容易读、写和随意改。
  • Markdown 是一种书写的格式,HTML 是一种发布的格式。
  • Markdown 的格式语法只涵盖纯文本可以涵盖的范围。

Headers 标题


1
2
3
4
5
6
# H1
## H2
### H3
#### H4
##### H5
###### H6


另外,H1和H2还能用以下方式显示:

1
2
3
4
5
6
7
一级标题
===



二级标题
---

Emphasis 文本强调


1
2
3
*斜体*         or   _强调_
**加粗** or __加粗__
***粗斜体*** or ___粗斜体__


但是,如果你的 *_ 两边都有空白的话,它们就只会被当成普通的符号: 这是一段 *文本强调* 的说明示例。
如果要在文字前后直接插入普通的星号或底线,你可以用反斜杠(转义符): \*这是一段被星号包围的文字\*

Lists 列表


Unordered 无序列表

1
2
3
4
5
6
7
8
9
10
11
12
13
* 无序列表子项1
* 无序列表子项2
* 无序列表子项3


+ 无序列表子项1
+ 无序列表子项2
+ 无序列表子项3


- 无序列表子项1
- 无序列表子项2
- 无序列表子项3


Ordered 有序列表

1
2
3
4
5
6
7
8
1. 有序列表子项1
2. 有序列表子项2
3. 有序列表子项3


1. 有序列表子项1
- 有序列表子项2
- 有序列表子项3


组合

1
2
3
4
5
6
7
8
9
10
11
12
13
14
* 产品介绍(子项无项目符号)
此时子项要以一个制表符 或者 4个空格 缩进


* 产品特点
1. 特点1
2. 特点2
3. 特点3


* 产品功能
1. 功能1
- 功能2
- 功能3


可有时我们会出现这样的情况,首行内容是以日期或数字开头: 2019. 公司年度目标。
为了避免也被转化成有序列表,我们可以在”.”前加上反斜杠(转义符): 2019\. 公司年度目标。


inline-style 内嵌方式

1
2
3
4
5
6
7
8
9
10
11
语法:
[link-text](url-link "optional-tips")

解释:
link-text:显示的链接文本
url-link:url链接
optional-tips:当鼠标放在 link-text 上显示的提示

示例:
[Markdown快速入门](https://www.yuque.com/xiaokongping/md/quick-start "Markdown快速入门")


Reference-style 引用方式

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
语法:
[link-text][reference-id]

[reference-id]:url-link "optional-tips" (在同一个文件的其它段落定义)

解释:
link-text: 显示的链接文本
reference-id: 链接的ID
optional-tips:当鼠标放在 link-text 上显示的提示

示例:
[百度搜索][baidu]

[baidu]:www.baidu.com "使用百度进行搜索"

注意: [link-text][reference-id] 与 [reference-id]:url-link "optional-tips"
之间要至少有一行的的间距


Email 邮件

1
<mazhili1991@ailiyun.com>

Images 图片


inline-style 内嵌方式

1
![替代文字](http://statics.w3cschool.cn/images/w3c/index-logo.png "标题文字")


Reference-style 引用方式

1
2
3
![替代文字][logo]

[logo]: http://statics.w3cschool.cn/images/w3c/index-logo.png "标题文字"

Code and Syntax Highlighting 代码和语法高亮


标记一小段行内代码

1
2
3
4
5
语法:
`这是被包裹的文字`

示例:
不是因为寂寞才想你,只是因为`想你`才寂寞。


如果高亮的内容包含 ` 号,可以这样写

1
`` `被包裹的文字` ``


**语法高亮:**

html代码
1
2
```html
<div>Syntax Highlighting</div>
1
2
3
4
5
6
css代码
```markdown
```css
body {
font-size: 12px;
}
1
2
3
4
5
JavaScript代码
```markdown
```javascript
let s = 'JavaScript syntax highlighting'
alert(s)
1
2
3
4
5
6
php代码
```markdown
```php
<?php
echo 'Hello, World!'
?>
1
2
3
4
5
python代码
```markdown
```python
s = Python syntax highlighting
print s
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16

<br />

<a name="Oi5PU"></a>
## Block Code 代码分组(代码区块)

---

Blockquotes 引用,在该行开头缩进4个空格或一个制表符(tab)
```markdown
> Email-style angle brackets
> are used for blockquotes.
> > And, they can be nested.
> #### Headers in blockquotes
> * You can quote a list.
> * Etc.

Hard Line Breaks 换行


在一行的结尾处加上2个或2个以上的空格,也可以使用
标签

1
2
3
4
5
6
第一行文字   
第二行文字

或者

第一行文字<br>第二行文字

Horizontal Rules 水平分割线


三种方式添加水平分割线

1
2
3
4
5
6
7
8
1:
***

2:
* * *

3:
- - -

Escape character 转义符(反斜杠)


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

1
\*这里是被强调的文字\*


Markdown 支持以下这些符号前面加上反斜杠来帮助插入普通的符号:

1
2
3
4
5
6
7
8
9
10
11
12
\反斜杠  
`反引号
*星号
_下划线
{}花括号
[]方括号
()括弧
#井字号
+加号
-减号
.英文句
!感叹号


Addtional 补充:
Markdown也支持传统的HTML标签。
比如一个链接,你不太喜欢Markdown的写法,也可以直接写成:

1
<a href="https://www.baidu.com">百度一下</a>

附录


Markdown 官网:http://daringfireball.net/projects/markdown/


参考资料:https://markdown.tw/


Markdown 在线编辑器: