Markdown 快速入门上(基础语法篇)
1. 简介
为什么使用Markdown
-
Markdown与平台无关。你可以在任何操作系统中打开Markdown文档。
-
Markdown无处不在。像Reddit和GitHub 站都是支持Markdown的,并且越来越多的 站会加入到Markdown队列中来,这是一个趋势。
2. 基本语法
Markdown的语法可以分为基本语法 和扩展语法, 市场的Markdown应用都应该支持基本语法。
一、标题
Markdown 在创建标题时需要在文字或者段落的前面加上**#符 ,#**的数量取决于当前标题的级别,如下
-
示例
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题 -
效果
一级标题
二级标题
三级标题
四级标题
五级标题
对于一级标题和二级标题还有一种语法可以来标记,可以在一级标题下面加任意数量的**==, 在二级标题下加任意数量的–**,具体效果如下
- 示例
一级标题
====
二级标题
—-
- 效果
一级标题
二级标题
二、段落
创建段落时候 ,可以使用空行来隔离一行或者多行。除非段落是列表, 否则不要使用空格或者TAB来缩进段落。
-
示例
散文,汉语词汇,拼音是sǎn wén。一指文采焕发;二指犹行文; [1] 三指文体名。随着时代的发展,散文的概念由广义向狭义转变,并受到西方文化的影响。
《辞海》认为:中国六朝以来,为区别韵文与骈文,把凡不押韵、不重排偶的散体文章(包括经传史书),统称“散文”。后又泛指诗歌以外的所有文学体裁。
三、强调(字体)
Markdown可以将字体格式化为加粗或者斜体。
- 加粗
在文字前后都加上两个星 或者下划线来将其中间的文字加粗, 注意的是星 或者下划线与文字之间不能有空格。
- 示例
- 效果
需要注意的是有时候下划线无法处理连续文字的中间部分,这个时候就需要使用星 来处理。所以一般的,推荐使用星 来加粗。
Do this | Don’t do this |
---|---|
Love**is**bold | Love__is__bold |
- 斜体
在文字前后都加上单个星 或者下划线来将其中间的文字加粗, 注意的是星 或者下划线与文字之间不能有空格。
- 示例
- 效果
需要注意的是有时候下划线无法处理连续文字的中间部分,这个时候就需要使用星 来处理。所以一般的,和加粗一样推荐使用星 来加粗。
Do this | Don’t do this |
---|---|
Love*is*bold | Love_is_bold |
- 加粗并倾斜
在文字前后都加上三个连续的星 或者下划线来将其中间的文字加粗并倾斜, 注意的是星 或者下划线与文字之间不能有空格。使用方法和上面两种一致。这里仅以星 为例:
- 示例
- 效果
四、引用块
Markdown在每行使用一个**>来标记引用一行,自然在引用多行时就需要在多行都使用>**来标记,并且可以和其它标记元素嵌套使用。
- 多行引用
-
示例
> ## 绝句
>两个*黄鹂**鸣翠柳,一行白鹭上青天。
>
>窗含西岭*千秋雪,门泊东吴万里船。 -
效果
两个黄鹂鸣翠柳,一行白鹭上青天。
窗含西岭千秋雪,门泊东吴万里船。
- 嵌套引用
Markdown可以在每行多个**>来嵌套引用,>**的个数表示引用嵌套的层数。
- 示例
>两个黄鹂鸣翠柳,一行白鹭上青天。
>>两个黄鹂鸣翠柳,一行白鹭上青天。
>>>两个黄鹂鸣翠柳,一行白鹭上青天。
>>>>两个黄鹂鸣翠柳,一行白鹭上青天。
>>>>>两个黄鹂鸣翠柳,一行白鹭上青天。
- 效果
两个黄鹂鸣翠柳,一行白鹭上青天。
两个黄鹂鸣翠柳,一行白鹭上青天。
两个黄鹂鸣翠柳,一行白鹭上青天。
两个黄鹂鸣翠柳,一行白鹭上青天。
两个黄鹂鸣翠柳,一行白鹭上青天。
五、列表
Markdown中列表可以分为两种,分别是有序列表和无序列表。列表可以与其他的标记符 进行嵌套使用。
有序列表
在纯文本前面加数字和英文句 表示一个有序列表。注意其中Markdown 语法没有要求数字是连续的,但是列表必须以数字1开头。显示效果会自动从1开始递增。
- 示例
1. 第一项
3. 第二项
5. 第三项
4. 第四项
- 效果
- 第一项
- 第二项
- 第三项
- 第四项
无序列表
无序列表可以在文本前面通过使用破折 (-),星 (*),或者加 (+)中的任意一种来标记。并且通过缩进来表示嵌套的列表。以下以加 (+)作为例子来演示。
-
示例
+ 第一项
+ 第二项
+ 嵌套列表第一项
+ 嵌套列表第二项
+ 第三项 -
效果
- 第一项
- 第二项
- 嵌套列表第一项
- 嵌套列表第二项
- 第三项
注意在一个列表中请务必使用同一种标记符 。
有序列表和无序列表嵌套
- 示例
1. 第一项
3. 第二项
5. 第三项
+ 嵌套第一项
+ 嵌套第二项
4. 第四项
- 效果
- 第一项
- 第二项
- 第三项
- 嵌套第一项
- 嵌套第二项
- 第四项
六、 图片
在Markdown文档中插入图片的基本语法如下:
-
语法: 
- tag: 用来描述图片的关键词
- link address: 图片的绝对地址,可以是本地的也可以是 络的
- title: 当鼠标悬置于图片上时,出现的文字标题内容
-
示例
 -
效果
由于本地图片只能在本地引用,这样在其他平台打开的话,图片就会失效,这个时候有一种方法就是将图片放在永久有效的 络服务器上,称之为图床。这里关于创建图床的方法可以参考: 图床连接简书连接 。
七、 代码
- 代码
一般地需要将文字或者段落表示为代码时,可以使用反引 来标记(`). 当段落中原本就有反引 的情况下需要使用双反应 来标记(“)
- 示例
At the command prompt, type `nano`.
“At the command prompt, type `nano`. “
- 效果
At the command prompt, type .
- 列表中代码块
在Markdown中一般的代码块是通过缩进四个空格或者一个Tab来标记的。但是当这部分代码块是嵌套在列表中时,必须使用八个空格或者两个Tab来标记。
-
效果
-
Open the file.
-
Find the following code block on line 21:
-
Update the title to match the name of your website.
-
八、水平分割线
水平分割线可以用三个或者多个星 (***), 破折 (—), or 下划线(___) 来标记。为了兼容性,推荐在水平分割线前后加上空行。
- 示例
***
—
___
- 效果
九、 超链接
在Markdown文档中插入超链接的基本语法主要有两种,每一种都可以与其它标记符 嵌套使用。
- 带标题的超链接
-
语法: [title](URL Address)
- title: 在文档中显示的关于超连接诶的提示内容
- URL Address: 超链接地址
-
示例
前面在图片章节实际上已经插入过超链接,这里再次作为示例来演示。
**[图床连接简书连接](https://www.jianshu.com/p/ea1eb11db63f)**
- 效果
图床连接简书连接
-
直接显示地址的超链接
Markdown中可以直接将URL或者邮箱地址直接放在尖括 中间来标记为插连接,鼠标点击该链接即可跳转到对应 页上去。对于点击邮箱地址,如果你安装了邮箱应用,那就直接跳转到写邮件页面。
- 示例
<https://www.jianshu.com/p/ea1eb11db63f>
- 效果
https://www.jianshu.com/p/ea1eb11db63f
十、 转义字符
由于标记字符都是作为格式化用途并不能被显示,markdown 和大多数其他语言一样使用反斜杠() 来转义,意思就是不要把 后面的地府识别为标记字符。
可被转义的标记字符如下表:
标记字符 | 名字 |
---|---|
backslash | |
` | backtick (see also escaping backticks in code) |
* | asterisk |
– | underscore |
{ } | curly braces |
[ ] | brackets |
( ) | parentheses |
# | pound sign |
+ | plus sign |
– | minus sign (hyphen) |
. | dot |
! | exclamation mark |
| | pipe (see also escaping pipe in tables) |
文章知识点与官方知识档案匹配,可进一步学习相关知识CS入门技能树MarkDown入门MarkDown介绍24799 人正在系统学习中
声明:本站部分文章及图片源自用户投稿,如本站任何资料有侵权请您尽早请联系jinwei@zod.com.cn进行处理,非常感谢!