什么是Markdown?
Markdown是一门轻量级标记语言(ML),纯文本文件,因此可以使用任意文本编辑器编辑和使用。
Markdown 语言在 2004 由约翰·格鲁伯(John Gruber)创建。
Markdown 文档支持导出为 HTML 、Word文档、RTF、图像、PDF、Epub、LaTeX和文本 等多种格式文件。
Markdown 编写的文档后缀为 .md、.markdown。
Markdown支持嵌入部分HTML代码,例如下划线、表格和指定字体属性等。
为什么使用Markdown?
Markdown作为文本文件,编辑器多样化,文件导出格式多元化。天生具有跨平台特性,部分编辑器支持实时预览,轻松上手。
Markdown 常用编辑器有三类。
第一类是在线集成工具,例如OSChina和简书等,具有在线编辑、保存发布功能。
第二类是独立软件,例如Atom、Typora等,一般均为跨平台开发工具。
第三类为多功能代码编辑软件,例如Visual Studio Code、SublimeText、HBuilder X 和Atom 编辑器等,通过插件支持编辑和导出等操作。
Markdown标题(注意字体段落前显示段落显示效果)
Markdown标题分为两组,一组分别是大标题和小标题。大标题使用=表示,小标题使用-表示。
大标题
<font color=red>注意:连续3个-或*也表示分割线。</font>
小标题
另一组使用#表示1-6级标题(H1-H6),具体使用如下
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题
显示效果见大纲视图下表
一级标题
二级标题
三级标题
四级标题
五级标题
六级标题
字体
Markdown常见字体效果有加粗、斜体、加粗斜体和删除线等。* 和** 表示斜体和粗体。
下划线字体使用u标签。<u>下划线字符</u>
**加粗文字**
*斜体文字*`
***斜体加粗文字***
~~删除线文字~~
温馨提示:**`**字符位于键盘Esc和Tab中间位置。
字体属性可以直接手动设置。例如指定字体、字号和颜色等。
<font face="微软雅黑" >微软雅黑字体</font>
<font face="黑体" >黑体</font>
<font size=3 >3号字</font>
<font size=4 >4号字</font>
<font color=#FF0000 >红色</font>
<font color=#008000 >绿色</font>
<font size=4 face="仿宋" color="red">4号仿宋红色字体</font>
<font face="微软雅黑">微软雅黑字体</font>
<font face="黑体">黑体</font>
<font face="SIMYOU">幼圆字体</font>
<font size =3>3号字体</font>
<font size=5>5号字体</font>
<font color=#008000 >绿色字体</font>
<font size=4 face="仿宋" color="red">4号仿宋红色字体</font>
引用(区块)
引用使用>符号,可以多次嵌套使用。
>根引用
>>二级引用
>>>三级引用
根引用
二级引用
三级引用
超链接
使用 [描述](链接地址) 为文字增加外链接。
例如 [OSChina开源中国](https://www.oschina.net)
开源中国首页:OSChina开源中国
Markdown 支持使用文本强调标注。
列表
列表分为无序列表和有序列表,和HTML列表有些类似。*+-均可作为列表表示符号,符号后需要加上一个空格,未加空格显示异常。列表支持嵌套。
无序列表
- 列表内容
+ 列表内容
* 列表内容
*列表内容
- 列表内容
- 列表内容
- 列表内容
有序列表
有序列表使用数字+.,同时使用空格分隔。
1. 列表内容
2. 列表内容
3. 列表内容
- 列表内容
- 列表内容
- 列表内容
嵌套列表
嵌套内容表示符号和一级列表内容需要<font color="red">保留3个以上空格</font>,同时不能省略*+-后空格。
-
一级列表内容
- 一级列表嵌套内容
- 一级列表嵌套内容
-
一级列表内容
- 一级列表嵌套内容
-
一级列表内容
- 一级列表嵌套内容 列表和
-
第一项
-
想·第二项
引用和表格可以嵌套。
> Markdown教程
* 咸鱼有梦想
Markdown教程
- 咸鱼有梦想
表格
Markdown支持简单表格,可以设置对齐方式。|分隔单元格, ---分隔列, :和---配合设置对齐格式。支持直接嵌入HTML表格代码。
name | birthday
--- | ---
张三 | 1977-7-9
Tom | 2018-1-1
| name | birthday |
|---|---|
| 张三 | 1977-7-9 |
| Tom | 2018-1-1 |
表格两端推荐使用|并使用空格。
| name | birthday | 住址 |
| --- | --- | --- |
| 张三 | 1977-7-9 | 中国 |
| Tom | 2018-1-1 | 美国 |
| name | birthday | 住址 |
|---|---|---|
| 张三 | 1977-7-9 | 中国 |
| Tom | 2018-1-1 | 美国 |
表格对齐示例代码和效果。
| 表格标题 | Title | 表格 |
| :--- | :----: | ----: |
| 左对齐 | 居中对齐 | 右对齐 |
| left | middle | right |
| 表格标题 | Title | 表格 |
|---|---|---|
| 左对齐 | 居中对齐 | 右对齐 |
| left | middle | right |
Exceltk 支持将Excel文件转换为Markdown表格。ExceltkGithub项目地址
代码
`单行代码`
`System.out.println("Hello world.");`
Java代码演示单行代码块。
System.out.println("Hello world.");
C#代码演示多行代码块。
```
//交换变量练习
int x, y;
int temp;
x = 0;
y = 1;
Console.WriteLine(x.ToString(), y.ToString());
temp = x;
x = y;
y = temp;
Console.WriteLine(x.ToString(), y.ToString());
```
图片
Markdown支持本地和超链接图片。
需要指出本地图片可能会因为文件被移动、删除或改名等原因导致无法显示。互联网图片需要联网才能加载正常。
联网图片:百度首页图片

使用本地图片建议将图片和Markdown文件放在相同文件夹,并为图片等多媒体创建文件夹,网络上部分教程推荐使用图片服务器加速,我推荐使用博客等加速。
本地图片演示。可以同时设置图片标题和缩放等。
温馨提示:图片地址修改后需要重新指定正确地址。
<img src="https://oscimg.oschina.net/oscnet/up-759ae20f14c8e3d074f8b05ded91b57d4ff.JPEG" alt="huaji" style="zoom: 33%;" />
转义符
页面中不可避免会出现 * 等特殊字符。需要使用转义字符。
需要转义字符主要有.、 +、-、*、!、`、\、_、和{}、()、和[]等。
数学公式
Markdown数学公式使用mathjax渲染。支持美元符号$ 包裹。
$$
E=mc^{2}
$$
$$ E=mc^{2} $$
流程图
支持简单流程图绘制。流程图支持普通流程图、甘特图和时序图等,属于高级操作。
flow
st=>start: Start
op=>operation: operating conditions
cond=>condition: Yes or No?
e=>end
st->op->cond
cond(yes)->e
cond(no)->op
```flow
脚注和参考文献
脚注、公式和参考文献等推荐学习基础LaTeX知识,同时安装好Pandoc并学习。
Happy Markdown!
来源:oschina
链接:https://my.oschina.net/u/1011130/blog/3190694