Markdown语法


先是使用了为知笔记,接触到Markdown,后来又在github玩起了博客,Markdown就更加必不可少了,在使用为知笔记的过程中,由于为知笔记有很多的bug,自己也是新手,所以用的很不顺手,走了很多的弯路,后来改用sublime编辑,果然好很多,推荐大家也用sublime进行编辑。下面呢是我在用Markdown过程中学到到语法和总结的一些使用心得和方法。持续更新哦!

由于我使用了yelee主题,所以显示的效果会不一样哦。

关于标题

在行首插入 1 到 6个#,分别表示标题 1 到标题 6,语法如下:

1
2
3
4
5
6
# 这是标题1
## 这是标题2
### 这是标题3
#### 这是标题4
##### 这是标题5
###### 这是标题6

效果展示:
标题

显示文本

普通文本

文本顶格写就会显示普通文本。

超链接文本

直接输入超链接的URL会自动变成可链接的形式。
http://foreverz.cn

单行文本

在行首增加1个tab或者4个空格就可以达到这种效果。

文本块

在连续几行的开头加入1个tab或者8个空格,这段文本就会形成文本块。还可以多加tab或空格形成层级。

欢迎到访。
    我已经在你的世界路过。
希望您开心快乐每一天。

文字高亮

使行内部分文字高亮,来强调显示需要用一对反引号``(tab上方的按键)包围起来。
HTML,CSS,javascript;

粗体、斜体、删除线

粗体:在文字前后添加 ** (注意符号与文字间不要有空格)
斜体:在文字前后添加 *
删除线:在文字前后添加 ~~
语法和显示效果如下:

语法 效果展示
*斜体1* 斜体1
_斜体2_ 斜体2
**粗体1** 粗体1
__粗体2__ 粗体2
~~删除线~~ 删除线

然后自由搭配也可以实现斜粗体斜粗删除线等效果

插入链接

[描述](链接地址 悬停显示),例如:

1
[我的博客](http://foreverz.cn 'forever')

或者这样表示:

1
2
3
4
[我的博客][forever]
[forever]:http://foreverz.cn 'forever'
[forever]:http://foreverz.cn "forever"
[forever]:http://foreverz.cn (forever)

这里的三种定义都是完全相同的。这是用到了URL标识符,可以达到复用的目的,一般把全文的URL标识符放到文章末尾,这样比较干净,以方便修改。
效果展示:
我的博客

插入图片

语法如下:

1
[![alt](imgSrc 'title')](hrefURL)

alt是在图片加载失败时显示的替代文字,imgSrc是图片的URL,title是鼠标悬停图片上时现实的文本,hrefURL图片的超链接地址。
也可以写成这样:

1
2
[![alt](imgSrc 'title')][href]
[href]:hrefURL

这样也是复用的写法。
其中,alt,title和href都可以省略,省略后的最简单的语法如下:

1
![](imgSrc)

或者这样表示:

1
2
![alt][id]
[id]:imgSrc 'title'

示例:

1
2
![](http://foreverz.cn/img/avatar.png 'forever')
[![forever](http://foreverz.cn/img/avatar.png 'forever')](http://foreverz.cn)

效果展示:

forever

列表

有序列表

在行首增加 1. 、 2. 、 3. ,即数字和英文句点, 不要求数字一定要连续,可以都是 1.,后面加一个空格。

1
2
3
1. 有序列表
1. 有序列表
4. 有序列表

效果展示:

  1. 有序列表
  2. 有序列表
  3. 有序列表

此外还有二级列表和三级列表等,语法如下;

1
2
3
4
5
6
1. 有序列表
1.1 二级列表
1. 有序列表
2.1 二级列表
2.1.1 二级列表
4. 有序列表

效果展示:

  1. 有序列表
    1.1 二级列表
  2. 有序列表
    2.1 二级列表
    2.1.1 二级列表
    
  3. 有序列表

无序列表

在行首增加 * 、+ 或 -,后面跟一个空格,语法如下:

1
2
* 无序列表
* 无序列表

效果展示:

  • 无序列表
  • 无序列表

此外还有二级列表和三级列表等,语法如下;

1
2
3
4
5
* 无序列表
* 二级列表
* 无序列表
* 二级列表
* 三级列表

效果展示:

  • 无序列表
    • 二级列表
  • 无序列表
    • 二级列表
      • 三级列表

注意:使用列表时需要在后面加上空行与其它内容区隔开,否则会被加入最后一个列表里。

任务清单

列表可被转换为任务清单,只要在列表项开头加上 或者[x],(分别表示已完成和未完成)。
语法如下:

1
2
3
- [ ]HTML
- [ ]CSS
- [x]JavaScript

效果展示:

  • [ ]HTML
  • [ ]CSS
  • [x]JavaScript

转义字符

Markdown中的转义字符为\,可以转义的有:

1 2 3 4
\ 反斜杠 ` 反引号 * 星号 _ 下划线
{ } 大括号 [ ] 中括号 ( ) 小括号 # 井号
+ 加号 - 减号 . 英文句号 ! 感叹号

表格

1
2
3
| 为知笔记|更新 | 版本 |
|---------|-----|------|
| WizNote | Markdown| Latest |

效果展示:

blog system theme
github page hexo yelee

使用表格必须在前后加上空行与其它内容区隔开,否则表格无效。

引用

引用文本

在文字前添加 >
效果展示:

如果你无法简洁的表达你的想法,那只说明你还不够了解它。 – 阿尔伯特·爱因斯坦

多级引用
格式如下:

1
2
3
>中国
>>浙江
>>>杭州

效果展示:

中国

浙江

杭州

  • 使用引用时需要在引用后加上空行与其它内容区隔开,否则会被加入引用。

引用代码

需要引用代码时,如果引用的语句只有一段,不分行,可以用一个 ` 将语句包起来。
多行则要在代码前后增加 三个反单引号: ```,后面写上所引用的语言
格式如下
```javascript
for (var i = 0; i < 100; i++)
{
console.log(“hello markdown!\n”);
}
效果展示:

1
2
3
4
for (var i = 0; i < 100; i++)
{
console.log("hello markdown!\n");
}

生成目录

在任何你想要展示Markdown 笔记目录的地方,添加 [TOC] , 在阅读模式下,标题1~6样式的内容会被提取出来作为目录,相当于大纲功能。

文章目錄
  1. 1. 关于标题
  2. 2. 显示文本
    1. 2.1. 普通文本
    2. 2.2. 超链接文本
    3. 2.3. 单行文本
    4. 2.4. 文本块
    5. 2.5. 文字高亮
  3. 3. 粗体、斜体、删除线
  4. 4. 插入链接
  5. 5. 插入图片
  6. 6. 列表
    1. 6.1. 有序列表
    2. 6.2. 无序列表
    3. 6.3. 任务清单
  7. 7. 转义字符
  8. 8. 表格
  9. 9. 引用
    1. 9.1. 引用文本
    2. 9.2. 引用代码
  10. 10. 生成目录
|