Markdown基本语法
最近无意中发现了一款轻量级的标记语言,语法简单,排版方便,正好最近想学习大数据与机器学习相关的知识,并计划时常写一些博客来做笔记,感觉Markdown应该是比较适合编辑,所以把博客园的编辑器改成了markdown,并在以后的记录中习惯使用。下面就总结一些Markdown的基本语法方便随时查阅。
1.段落和换行
段落中如果要强制换行,可以输入两个空格键加一个回车键实现。
2.标题
标题设置有两种方式 第一种,标题前加 #
号表示,总共分为六级标题,建议在 #
号后加一个空格,这是最标准的Markdown语法。
# 标题一
## 标题二
### 标题三
#### 标题四
##### 标题五
###### 标题六
一级到六级演示效果分别如下:
标题一
标题二
标题三
标题四
标题五
标题六
第二种,通过在文字下方添加 =
或 -
,他们分别表示一级标题和二级标题。(任何数量的 =
或 -
效果相同)。
标题一
======
标题二
------
效果分别如下:
标题一
标题二
3.区块引用
如果需要引用一小段别处的句子,那么就要用引用的格式。
例如这样
只需在文本前加入 >
这种尖括号(大于号)即可。 区块引用可以嵌套(例如:引用内的引用),只要根据层次加上不同数量的 >
:
> 应用1
> > 嵌套引用
>
> 引用2
效果如下:
引用1
嵌套引用
引用2
4.粗体与斜体
Markdown的粗体和斜体也非常简单,用两个 *
包含一段文本就是粗体和语法,用一个 *
包含一段文本就是斜体的语法。
**这里是粗体** *这里是斜体*
效果为:这里是粗体 这里是斜体
5.列表
Markdown支持有序列表和无序列表。 无序列表只需在文字前加上星号、加号或是减号即可。
* Red
* Green
* Blue
等价于:
+ Red
+ Green
+ Blue
也等价于:
- Red
- Green
- Blue
效果如下:
- Red
- Green
- Blue
有序列表则使用数字接着一个英文句点:
1. Red
2. Green
3. Blue
效果如下:
- Red
- Green
- Blue
6.代码区块
代码区块中的内容不会进行排版,而是按照原来的样子显示。在Markdown中代码区只要简单的缩进4个空格或者1个制表符就可以。
这是一个普通段落:
这是一个代码区块。
7.分割线
你可以在一行中用三个以上的星号、减号、底线来建立一个分割线,行内不能有其他东西。你也可以在星号或是减号中间插入空格。下面每种写法都可以建立分割线:
* * *
***
*****
- - -
——————————————————————————————————————————
会产生两种效果的分割线,如下显示:
——————————————————————————————————————————
8.链接
Markdown中有两种方式实现链接,分别为内联方式和引用方式。不管是哪一种,链接文字都是用 [方括号] 来标记。
内联方式的链接,只要在方块括号后面紧接着圆括号并插入网址链接即可,如果你还想要加上链接的 title 文字,只要在网址后面,用双引号把 title 文字包起来即可:
This is [an example](http://example.com/ "Title") inline link.
[This link](http://example.net/) has no title attribute.
效果如下: This is an example inline link. This link has no title attribute.
如果你是要链接到同样主机的资源,你可以使用相对路径:
See my [About](/about/) page for details.
引用方式链接,使用另外一个方括号接在链接文字的括号后面,而在第二个方括号里面要填入用以辨识链接的标签:
This is [an example][id] reference-style link.
也可以选择性地在两个方括号中间加上空白:
This is [an example] [id] reference-style link.
接着,在文档的任意处,可以把这个标签的链接内容定义出来:
[id]: http://example.com/ "Optional Title Here"
链接定义的形式为:
- 方括号,里面输入链接的辨识用标签
- 接着一个冒号
- 接着一个以上的空白或 tab
- 接着链接的网址
- 选择性地接着 title 内容,可以用单引号、双引号或是括号包着
下面这三种链接的定义都是相同:
[foo]: http://example.com/ "Optional Title Here"
[foo]: http://example.com/ 'Optional Title Here'
[foo]: http://example.com/ (Optional Title Here)
网址定义只有在产生链接的时候用到,并不会直接出现在文档之中。 示例:
I get 10 times more traffic from [Google][1] than from [Yahoo][2] or [MSN][3].
[1]: http://google.com/ "Google"
[2]: http://search.yahoo.com/ "Yahoo Search"
[3]: http://search.msn.com/ "MSN Search"
效果如下: I get 10 times more traffic from Google than from Yahoo or MSN.
9.程序代码
如果要标记一小段行内程序代码,可以用反引号把它包起来(`
),例如:
Use the `printf()` function.
效果为: Use the printf()
function. 如果要在程序代码区段内插入反引号,可以用多个反引号来开启和结束程序代码区段:
``There is a literal backtick (`) here.``
`` There is a literal backtick (`) here. ``
效果为:There is a literal backtick (`) here.
10.图片
Markdown图片的语法和链接很相似,也分别为内联方式和引用方式。 内联方式图片的语法看起来像是:
![Alt text](/path/to/img.jpg)
![Alt text](/path/to/img.jpg "Optional title")
详细叙述如下:
- 一个惊叹号 !
- 接着一个方括号,里面放上图片的替换文字
- 接着一个普通括号,里面放上图片的网址,最后还可以用引号包住并加上 选择性的 'title' 文字。
引用方式图片语法类似这样:
![Alt text][id]
「id」是图片参考的名称,图片参考的定义方式则和链接参考一样:
[id]: url/to/image "Optional title attribute"
11.自动链接
Markdown 支持比较简短的自动链接形式来处理网址和电子邮件信箱,只要是用方括号包起来, Markdown 就会自动把它转成链接,链接的文字就和链接位置一样,例如:
<http://example.com/>
效果为: http://example.com/
12.转义字符
Markdown 可以利用反斜杠来插入一些在语法中有其它意义的符号,例如:如果想要用星号加在文字旁边的方式来做出强调效果(但不用 <em>
标签),可以在星号的前面加上反斜杠:
\*literal asterisks\*
Markdown 支持在下面这些符号前面加上反斜杠来帮助插入普通的符号:
\ 反斜杠
` 反引号
* 星号
_ 底线
{} 大括号
[] 方括号
() 括号
# 井字号
+ 加号
- 减号
. 英文句点
! 惊叹号
编辑器
本人使用的是Window系统,所以选择了MarkdownPad。
参考文献
http://daringfireball.net/projects/markdown/basics http://www.cnblogs.com/hnrainll/p/3514637.html http://www.ituring.com.cn/article/504 http://www.jianshu.com/p/1e402922ee32/
建议
建议初次接触Markdown语法的同学,可以像我这样在学习的过程中尝试写一个符合自己查阅习惯的总结,在总结完成以后,也就熟悉了Markdown语法的使用。本篇博客是用Markdown所写,文章最后会给出源文件下载地址,希望想学习的同学可以作为一个参考。