GcsSloop

Just do IT later.

嗨,我是 GcsSloop,一名来自2.5次元的魔法师,Android自定义View系列文章作者,非著名程序员。


欢迎来到我的魔法世界!

Markdown实用技巧-基础语法

本文为 Markdown实用技巧 系列的基础文章,并没有不可描述的内容 (⊙ω⊙)

为保证语法兼容性,本文只介绍基础语法,扩展语法等其它内容,会在后续的文章中单独介绍。
注意:所有的标记符号均使用英文,中文无效。


标题

Markdown 支持多种标题格式。

利用 = (等号)和 -(减号)可以定义一级标题和二级标题,(任何数量的 =- 都有效果) :

Markdown 预览
一级标题
====

一级标题

二级标题
----

二级标题

通过在行首插入 1 到 6 个 # ,来定义对应的 1 到 6 阶 标题,个人推荐使用这种,例如:

Markdown 预览
# 一级标题

一级标题

## 二级标题

二级标题

### 三级标题

三级标题

#### 四级标题

四级标题

##### 五级标题
五级标题
###### 六级标题
六级标题

段落和换行

在 Markdown 中段落由一行或者多行文本组成,相邻的两行文字会被视为同一段落,如果存在空行则被视为不同段落( Markdown 对空行的定义是看起来是空行就是空行,即使空行中存在 空格 TAB 回车 等不可见字符,同样会被视为空行)。

Markdown支持段内换行,如果你想进行段落内换行可以在上一行结尾插入两个以上的空格后再回车。

Markdown 预览
第一行
相邻被视为同一段落。

第一行 相邻被视为同一段落。

第一行[空格][空格]
上一行结尾存在两个空格,段内换行

第一行
上一行结尾存在两个空格,段内换行。

第一行

两行之间存在空行,视为不同段落。

第一行

两行之间存在空行,视为不同段落。


强调

删除线的 ~ 符号一般位于键盘左上角位置。

Markdown 预览
*倾斜* 倾斜
**粗体** 粗体
~~删除线~~ 删除线
> 引用
引用

链接和图片

为了规避某些平台的防盗链机制,图片推荐使用图床,否则在不同平台上发布需要重新上传很麻烦的,图床最好选大平台的图床,一时半会不会倒闭的那种,个人目前主要用的是微博图床 Chrome插件-微博图床 以及 Alfred脚本-微博图床

Markdown 预览
[GcsSloop](http://www.gcssloop.com) GcsSloop
![GcsSloop Blog](http://www.gcssloop.com/assets/siteinfo/friends/gcssloop.jpg) GcsSloop Blog

列表

无序列表前面可以用 * + - 等,结果是相同的。
有序列表的数字即便不按照顺序排列,结果仍是有序的。

Markdown 预览
* 项目
* 项目
* 项目
  * 子项目
  * 子项目
* 项目
  • 项目
  • 项目
  • 项目
    • 子项目
    • 子项目
  • 项目
1. 项目
2. 项目
3. 项目
  1. 子项目</span>
  2. 子项目
4. 项目
  1. 项目
  2. 项目
  3. 项目
    1. 子项目
    2. 子项目
  4. 项目

下划线和特殊符号

由于 Markdown 使用一些特殊符号进行标记,当我们想要在文档中使用这些特殊符号并防止被 Markdown 转换的时候,可以使用 \ (转义符) 将这些特殊符号进行转义。

Markdown 预览
在一行中用三个以上的星号、减号、下划线来建立一个分隔线
---

可以利用反斜杠(转义字符)来插入一些在语法中有特殊意义的符号
\*Hi\*
*Hi*

代码

1.行内代码

行内代码可以使用反引号来标记(反引号一般位于键盘左上角,要用英文):

一句话 `行内代码` 一句话。

预览:

一句话 行内代码 一句话。

2.多行代码

多行代码使用 3 个反引号来标记(反引号一般位于键盘左上角,要用英文) ,在第一个 ``` 后面可以跟语言类型,没有语言类型可以省略不写:

​``` java
// 我是注释
int a = 5;
​```

预览:

// 我是注释
int a = 5;

表格

扩展的 Markdown 支持手写表格,格式也非常简单,第二行分割线部分可以使用 : 来控制内容状态。
注意,Markdown 标准(原生)语法中没有表格支持,但现在多数平台已经支持了该语法,如 GitHub,CSDN,简书 等均支持,所以写在这里:

Markdown:

| 默认  |   靠右 |  居中  | 靠左   |
| ---- |  ---: | :--:  | :---  |
| 内容  |   内容 |  内容  | 内容   |
| 内容  |   内容 |  条目  | 内容   |

预览:

默认 靠右 居中 靠左
内容 内容 内容 内容
内容 内容 条目 内容
发现宝藏?

参考资料

Markdown-语法说明

About Me

作者微博: @GcsSloop


如果你觉得我的文章对你有帮助的话,捐赠一些晶石,鼓励我继续研究!

¥ 捐赠晶石
最近的文章

安卓自定义View进阶-MotionEvent详解

Android MotionEvent 详解,之前用了两篇文章 事件分发机制原理 和 事件分发机制详解 来讲解事件分发,而作为事件分发主角之一的 MotionEvent 并没有过多的说明,本文就...…

CustomView

继续阅读
更早的文章

Markdown实用技巧-快速入门

本文为 Markdown实用技巧 系列的基础文章,并没有不可描述的内容 (⊙ω⊙)自从接触了 Markdown 之后,就一直用 Markdown 作为自己的主要书写工具,不论是平时做一些简单的纪...…

Markdown

继续阅读