玩转Markdown

原创文章，版权所有，转载请注明出处。
本文来自小学生辉辉辉的博客 http://blog.csdn.net/xxshhh
欢迎来访，您的评论和点赞就是对我莫大的支持~~~

玩转Markdown

Markdown 作为当前最流行的写作工具之一，无处不在使用，如 GitHub、CSDN、简书、Hexo 静态博客等，故细心整理一番，一起玩转 Markdown。

Markdown Syntax

Markdown 是一种轻量级标记语言。

官方语法主要有：

• Headers - 标题

# 一级标题
## 二级标题
###### 六级标题
注：至多六级标题

• Emphasis - 强调

*斜体*
_斜体_

**粗体**
__粗体__

• Blockquotes - 引用

> 细节决定成败，态度决定一切。

• Lists - 列表

* 无序列表1
* 无序列表2
+ 无序列表1
+ 无序列表2
- 无序列表1
- 无序列表2

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

• Images - 图片

![图片名](图片地址)

• Links - 链接

[链接名](链接地址)

• Backslash Escapes - 反斜杠转义

支持反斜杠(\)转义的字符：
\ ' * _ {} []
() # + - . !

• 其他整理

(1) 换行：行尾至少2个空格
(2) 分隔线：单独一行输入至少3个短横线(-)、星号(*)或者下划线(_)
(3) 块代码：缩进4个空格或者1个制表符号
(4) 行内代码：反引号(`)前后包起来
(5) 自动链接：支持网址和邮箱，如<http://example.com/>、@example.com>

GitHub Flavored Markdown

GitHub 使用的是它自己的一个 Markdown 语法版本，GFM。

GitHub 风格相关语法主要有：

• Username @Mentions - 通知用户

@mention 可以通知到个人或者组织来查看评论

• Issue references - 问题参考

#number 可以自动链接到一个Issue或者Pull Request

• Emoji - 表情

www.emoji-cheat-sheet.com
这个网站列出了所有支持的表情，一般用法如：:smile:

• Fenced Code Blocks - 代码块

​```java
int x = 1;
int y = 2;
int z = x + y;
System.out.println(z);
​```

• Task Lists - 任务列表

- [X] 已完成任务
- [ ] 待完成任务

• Tables - 表格

| First Header  | Second Header |
| ------------- | ------------- |
| Content Cell  | Content Cell  |
| Content Cell  | Content Cell  |
注：
(1) 用连字符(-)来划分表示标题行，用竖线(|)来划分列与列
(2) 每行的前后竖线(|)可选，列的竖线(|)也不需要对齐，都只是为了方便阅读
(3) :--- 左对齐、:---: 中间对齐、---：右对齐

• 其他整理

(1) ~~删除线~~
(2) Commit SHAs自动变成链接：如 a5c3785

个人经验

• Typora - 极致简洁的 Markdown 编辑器

一些小技巧：
(1) [toc] 即Table of Contents，生成目录
(2) 支持 <u>下划线u>
(3) 支持 ==高亮==
(4) 使用 iPic - http://toolinbox.net/iPic/，支持拖拽上传图片至自定义图床，当前仅支持Mac版本

• 兼容HTML

不要忘记Markdown是兼容HTML的，强大的HTML，可以完成很多事情。
举个例子，
(1) 解决图片居中问题
(2) 解决自定义目录问题
(3) 添加音乐播放器外链

添加网易云音乐效果(注：Hexo、CSDN可以支持，简书、GitHub均不支持)：

border="0" width="330" height="86" src="http://music.163.com/outchain/player?type=2&id=5239883&auto=0&height=66">

参考

• GitHub Guides - Mastering Markdown
• markdown-cheatsheet-online.pdf
• GitHub Help - Writing on GitHub
• Typora - Markdown Reference

图片来自于Dribbble