Markdown，抛弃繁琐的格式

jiezi

6 年前

Markdown，抛弃繁琐，创作神器

Markdown 是一种可以使用普通文本编辑器编写的标记语言，通过简单的标记语法，它可以使普通文本内容具有一定的格式。 Markdown 的语法简洁明了、学习容易，而且功能比纯文本更强，因此有很多人用它写博客。世界上最流行的博客平台 WordPress 和大型 CMS 如 Joomla、Drupal 都能很好的支持 Markdown。完全采用 Markdown 编辑器的博客平台有 Ghost 和 Typecho；用于编写说明文档，并且以“README.MD”的文件名保存在软件的目录下面。 Markdown 抛弃了 word 等编辑的繁琐格式，它的简单易用让你更专注于创作。在这里，推荐一款 windows 平台下，个人认为好用的 markdown 编辑器——Typora
接下来，介绍常用的语法格式。
目录
语法格式：[TOC]
markdown 编辑器会生成一个目录
注：部分 md 编辑器不支持目录的语法，如简书
[TOC]
标题
标题有两种语法格式

第一种：
语法格式：#（# 的个数表示标题的大小）
标题分为 h1-h6，类似 HTML 的标题，逐步递减

例如：
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题

第二种：
语法格式：在标题底下加任意个 = 或 -
其中，= 代表一级标题，- 代表二级标题

例如：
一级标题（任意个）
======

二级标题（任意个）
——
标题示例：
一级标题
二级标题
三级标题
四级标题
五级标题
六级标题
一级标题（任意个）
二级标题（任意个）
列表
列表分为有序列表和无序列表两种

有序列表：
语法格式：数字（或字母）. 内容
注：这里的. 是英文格式下的.

例如：
1. 汉堡包
2. 薯条
3. 可乐

无序列表：
语法格式：– 或 * 或 +（空格）内容，作为无序列表标记。

例如：
+ 汉堡包
* 薯条
– 可乐

建立多级列表时，每个子级别都要比上个子级别前多打两个以上空格。
在 * 前加两个空格键或一个 tab 键就可以产生一个子列表。

无序列表示例：

汉堡包
薯条
可乐

有序列表示例：

汉堡包
薯条
可乐

引用
引用分为常规引用和分级引用

常规引用：
语法格式：>（空格）引用内容

分级引用：
语法格式：> 一级引用
>> 二级引用
>>> 三级引用

常规引用示例，引用中支持多级引用（嵌套引用）、标题、列表、代码块、分割线等

这是嵌套引用
// 嵌套引用代码块
public static void main(String[] args) {
System.out.println(“Hello World!”);
}

一级引用

二级引用
三级引用

文字样式
** 加粗文本 ** 或 __加粗文本__
* 斜体文本 * 或 _斜体文本_
*** 粗斜体 *** 或 ___粗斜体___
~~ 删除文本~~
` 底纹 `
:== 高亮 # 807700== 或 == 高亮 ==
非基本语法
字体上标、下标语法：
这是 上标文字 
这是 下标文字 
这是上标文字
这是下标文字
图片和链接
图片语法格式：
![]()
[]内表示图片描述，可忽略
()内表示链接的地址

链接语法格式：
[]()
[]内表示链接的描述
()内表示链接的地址

链接这里又分为行内式、参考式和自动链接。

行内式：以 [] 标记显示的链接文本，后面紧跟 () 包围链接，[文本](URL)
参考式：[文本][URL] [URL]:….
自动链接：<URL>
实例：
行内式
参考式,URL
自动链接 http://www.baidu.com
图片
代码块
语法格式：
行内代码语法格式：`Hello World`
代码不分行，只有一段

代码框语法格式：“` 代码片段 “`

行内代码实例：Hello World
代码框实例：
public static void main(String[] args) {
System.out.println(“Hello World”);
}

表格
表格语法
居左 |:—
居中 |:—:|
居右 —:|

| 标题 | 标题 | 标题 |
|:—|:—:|—:|
| 左 | 中 | 右 |

实例：

标题
标题
标题

左
中
右

分隔线
语法格式：
—
***
___

脚注
语法格式：
这是一个脚注例子[^ 脚注内容]

实例：
这是一个脚注例子 1
注释
注释语法格式：
<!– 注释 –>

实例：
<!– 注释 –>
增强 Markdown 的 HTML 标签
 字体样式

文本格式

换行

下划线

实例：
 字体样式 
 文本格式 
换行 
 下划线 
任务列表
– [] 任务内容 []之间带有空格

[]内填入 x 代表完成

注：部分 Markdown 编辑器不支持

– [] 未完成

– [x] 完成

实例：

[] 未完成
[x] 完成

转义字符
\ 代表转义

\* 转义实例 \*

实例：
* 转义实例 *
扩展
支持 jsfiddle、gist、runjs、优酷视频，直接填写 url，在其之后会自动添加预览点击会展开相关内容。

http://{url_of_the_fiddle}/embedded/[{tabs}/[{style}]]/
https://gist.github.com/{gist_id}
http://runjs.cn/detail/{id}
http://v.youku.com/v_show/id_{video_id}.html

http://{url_of_the_fiddle}/embedded/[{tabs}/[{style}]]/https://gist.github.com/{gist_id}http://runjs.cn/detail/{id}http://v.youku.com/v_show/id_{video_id}.html
公式
使用一对 $$ 包裹 TeX 或 LaTeX 格式的数学公式

$$ x = {-b \pm \sqrt{b^2-4ac} \over 2a}. $$

$$
x \href{why-equal.html}{=} y^2 + 1
$$

脚注内容 ↩