Markdown的认识与入门

Markdown是一种轻量级的「标记语言」，它的优点很多，目前也被越来越多的写作爱好者，撰稿者广泛使用。看到这里请不要被「标记」、「语言」所迷惑，Markdown 的语法十分简单。常用的标记符号也不超过十个，这种相对于更为复杂的HTML 标记语言来说，Markdown 可谓是十分轻量的，学习成本也不需要太多，且一旦熟悉这种语法规则，会有一劳永逸的效果。

• 创始人 John Gruber 的 Markdown 语法说明

使用 Markdown 的优点

1、专注你的文字内容而不是排版样式，安心写作。
2、轻松的导出 HTML、PDF 和本身的 .md 文件。
3、纯文本内容，兼容所有的文本编辑器与字处理软件。
4、随时修改你的文章版本，不必像字处理软件生成若干文件版本导致混乱。
5、可读、直观、学习成本低。

使用 Markdown 的误区

We believe that writing is about content, about what you want to say –
not about fancy formatting.

我们坚信写作写的是内容，所思所想，而不是花样格式。
— Ulysses for Mac

Markdown 旨在简洁、高效，也由于 Markdown 的易读易写，人们用不同的编程语言实现了多个版本的解析器和生成器。这就导致了目前不同的 Markdown 工具集成了不同的功能（基础功能大致相同），例如流程图与时序图，复杂表格与复杂公式的呈现。

虽然功能的丰富并没有什么本质的缺点，但终归有些背离初衷，何况在编写的过程中很费神，不如使用专业的工具撰写来的更有效率，所以如果你需实现复杂功能，专业的图形界面工具会更加方便。

当然，如果你对折腾这些不同客户端对 Markdown 的定制所带来高阶功能感到愉悦的话，那也是无可厚非的。

MarkDown语法的简要说明

注意：Markdown使用#、+、*等符号来标记， 符号后面必须跟上 至少1个 空格才有效！

标题 (两种方式：# 和 = 、-)

• 用#标记标题

# 一级标题
## 二级标题
### 三级标题
##### 四级标题
###### 五级标题
###### 六级标题

以此类推，总共六级标题，建议在井号后加一个空格，这是最标准的 Markdown 语法。

• 用 = 、- 来标记
• 在 标题底下 加上任意个=代表一级标题， - 代表二级标题

大标题
=
小标题
-

列表

无序列表：在文字前加上 - 、+、 * 加上空格，

- Red
- Green
- Blue

* Red
* Green
* Blue

+ Red
+ Green
+ Blue

有序列表：在文字前加 1、2、3，符号要和文字之间加上一空格。

1. Red
2. Green
3. Blue

列表嵌套

1. 列出所有元素：

   • 无序列表元素 A
     1. 元素 A 的有序子列表
   • 前面加四个空格

2. 列表里的多段换行：
   前面必须加四个空格，
   这样换行，整体的格式不会乱

3. 列表里引用：

   前面空一行
   仍然需要在 > 前面加四个空格

4. 列表里代码段：

   前面四个空格，之后按代码语法 ```书写
   

    或者直接空八格，引入代码块
   

• 列表嵌套需要在子列表前面打一个 tab 键/4个空格即可

引用

如果你需要引用一小段别处的句子，那么就要用引用的格式。

例如这样

只需要在文本前加入 > 这种尖括号（大于号）即可

引用嵌套

最外层引用

多一个 > 嵌套一层引用

可以嵌套很多层

引用里嵌套列表

• 这是引用里嵌套的一个列表
• 还可以有子列表
  • 子列表需要从 - 之后延后四个空格开始

> 这是一段引用    //在`>`后面有 1 个空格
> 
>     这是引用的代码块形式    //在`>`后面有 5 个空格
>     
> 代码例子：
>   
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
    }

> 一级引用
> > 二级引用
> > > 三级引用

> #### 这是一个四级标题
> 
> 1. 这是第一行列表项
> 2. 这是第二行列表项

链接与图片

插入链接与插入图片的语法很像，区别在一个 !号
链接：[内容 ]（url地址）
图片：![图片备注]（url地址）

高级链接技巧，声明一个链接名，可在文档多处引用。图片和链接都可以用这个方法

这个链接用 1 作为网址变量[baidu][1]
[1]:https:www.baidu.com

粗体与斜体

用1个 * 包含一段文本是斜体

用2个 * 包含一段文本是粗体

用3个 * 包含一段文本是粗斜体
斜体 粗体 粗斜体

表格

表头标题一	表头标题二
内容一	内容二

• 第二行定义了每一列的排列对齐方式

表格对齐格式
居左：:----
居中：:----:或-----
居右：----:

代码区

如果你是个程序猿，需要在文章里优雅的引用代码框，在 Markdown 下实现也非常简单，只需要用两个 ` 把中间的代码包裹起来，

• 使用 tab 键即可缩进。

分割线

在一行中用三个以上的*、-、_来建立一个分隔线。

行内HTML元素

目前只支持部分段内 HTML 元素效果，包括 <kdb> <b> <i> <em>> <sup> <sub> <br> ，如

• 健位显示 ： <kdb>
  使用 Ctrl+Alt+Del 重启电脑

• 代码块：<pre>
  使用

  元素同样可以形成代码块
  

符号转义

如果你的描述中需要用到 markdown 的符号，比如 _ # * 等，但又不想它被转义，这时候可以在这些符号前加反斜杠，如 _ # * 进行避免。

_不想这里的文本变斜体_
**不想这里的文本被加粗**

强调

两个*或-代表加粗，一个*或-代表斜体，~~代表删除。
**加粗文本** 或者 __加粗文本__

*斜体文本*  或者_斜体文本_

~~删除文本~~

效果如下：
加粗文本 或者 加粗文本

斜体文本 或者_斜体文本_

删除文本

换行

在行尾添加两个空格加回车表示换行：

这是一行后面加两个空格  换行

脚注(注解)

使用[^]来定义脚注：

这是一个脚注的例子[^1]

[^1]: 这里是脚注

这是一个脚注的例子¹

常用弥补MarkDown的HTML标签

###字体

<font face="微软雅黑" color="pink" size="6">字体及字体颜色和大小</font>
<font color="#0000ff">字体颜色</font>

字体及字体颜色和大小
字体颜色

换行

使用html标签`<br/>`<br/>换行

使用html标签<br/>
换行

文本对齐方式

<p align="left">居左文本</p>
<p align="center">居中文本</p>
<p align="right">居右文本</p>

居左文本

居中文本

居右文本

下划线

<u>下划线文本</u>

下划线文本

小结

到这里，Markdown 的基本语法在日常的使用中基本就没什么大问题了，只要多加练习，配合好用的工具，写起东西来肯定会行云流水。

---

1. 这里是脚注 ↩︎