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

效果如下:

  1. Red
  2. Green
  3. 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所写,文章最后会给出源文件下载地址,希望想学习的同学可以作为一个参考。

附件下载

posted @ 2016-08-15 11:01 jinhaolin 阅读(...) 评论(...) 编辑 收藏
作者:Leo Chin
出处:http://www.cnblogs.com/hnrainll/
本博客文章,大多系网络中收集,转载请注明出处
相关标签:嵌入式培训嵌入式开发嵌入式学习