常用Markdown语法教程

什么是 Markdown ?

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

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

总之, Markdown 的语法全由一些符号所组成,这些符号经过精挑细选,其作用一目了然。比如:在文字两旁加上星号,看起来就像强调。Markdown 的列表看起来,嗯,就是列表。Markdown 的区块引用看起来就真的像是引用一段文字,就像你曾在电子邮件中见过的那样。

常用语法

1. 标题

1
2
3
# 一级标题
## 二级标题
###### 六级标题
1
2
3
4
一级标题
============
二级标题
------------

任何数量的=-均有此效果。

2. 引用

1
2
3
> ### 标题
> 引用文字
>> 二级引用

效果:

标题

引用文字

二级引用

3. 列表

无序列表

使用*+-作为标记

1
2
3
* 北京
* 上海
* 广州

效果:

  • 北京
  • 上海
  • 广州

有序列表

1
2
3
1. 北京
2. 上海
3. 广州

效果:

  1. 北京
  2. 上海
  3. 广州

4. 代码块

​ 代码,左侧有一个制表符或四个空格。

更高级的代码块,支持四十一种编程语言的语法高亮的显示,行号显示。

1
2
3
4
5
6
7
8
9
10
11
12
@requires_authorization
def somefunc(param1='', param2=0):
'''A docstring'''
if param1 > param2: # interesting
print 'Greater'
return (param2 - param1 + 1) or None

class SomeClass:
pass

>>> message = '''interpreter
... prompt'''

5. 链接

[文本](链接)

示例:

我的博客

6. 插入图片

使用 ![描述](图片链接地址) 插入图像。

示例:

我的头像

7. 表格

项目 价格 数量
计算机 \$1600 5
手机 \$12 12
管线 \$1 234
坚持原创技术分享,您的支持将鼓励我继续创作!
0%