共计 2506 个字符,预计需要花费 7 分钟才能阅读完成。
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== 或 == 高亮 ==
非基本语法
字体上标、下标语法:
这是 <sup> 上标文字 </sup>
这是 <sub> 下标文字 </sub>
这是上标文字
这是下标文字
图片和链接
图片语法格式:
![]()
[]内表示图片描述,可忽略
()内表示链接的地址
链接语法格式:
[]()
[]内表示链接的描述
()内表示链接的地址
链接这里又分为行内式、参考式和自动链接。
行内式:以 [] 标记显示的链接文本,后面紧跟 () 包围链接,[文本](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 标签
<font face=” 微软雅黑 ” color=”red” size=”6″> 字体样式 </font>
<p align=”left/right/center”> 文本格式 </p>
换行 <br/>
<u> 下划线 </u>
实例:
<font face=” 微软雅黑 ” color=”red” size=”6″> 字体样式 </font>
<p align=”left/right/center”> 文本格式 </p>
换行 <br/>
<u> 下划线 </u>
任务列表
– [] 任务内容 []之间带有空格
[]内填入 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
$$
$$
x \href{why-equal.html}{=} y^2 + 1
$$
脚注内容 ↩