段落与换行
换行最好在前一段字符串后加两个空格
两行之间不管有多少空行,显示都是一个空行
唯一决定两行文字是否是段落的,就在于这两行文字之间是否有空行
段落也可以用p标签表示
标题
用1-6个#表示一到六阶标题,可以在标题前加#,也可以前后都加
分割线
你可以在一行中用三个以上的星号、减号、底线来建立一个分隔线,行内不能有其他东西。你也可以在星号或是减号中间插入空格
** 注意 **
- atom底线未生效,建议用其他两种
区块引用
用>表示区块引用,区块引用可以用多个>表示嵌套,也可以用其他语法例如[> #]表示区块索引内的标题
结束可以用空行
列表
无序列表使用星号、加号或是减号作为列表标记
有序列表则使用数字接着一个英文句点
** 注意 **
- 符号后面需要加一个空格
- 行首出现数字-句点-空白,要避免这样的状况,你可以在句点前面加上反斜杠。
- tab表示缩进一个层级,可以实现列表的嵌套
代码区块
用<pre><code>表示代码区块。
代码区块中,一般的 Markdown 语法不会被转换,像是星号便只是星号
链接
Markdown 支持两种形式的链接语法: 行内式和参考式两种形式。
不管是哪一种,链接文字都是用 [方括号] 来标记。
1. 行内式:要建立一个行内式的链接,只要在方块括号后面紧接着圆括号并插入网址链接[百度一下](http://www.baidu.com)
2. 参考式:在链接文字的括号后面再接上另一个方括号,而在第二个方括号里面要填入用以辨识链接的标记
[百度一下][baidu]
在文件的任意处,你可以把这个标记的链接内容定义出来
** 注意 **
- 链接辨别标签可以有字母、数字、空白和标点符号,但是并不区分大小写
[baidu]:http://www.baidu.com
隐式链接标记:让你可以省略指定链接标记,这种情形下,链接标记会视为等同于链接文字,要用隐式链接标记只要在链接文字后面加上一个空的方括号,如果你要让 “Google” 链接到 google.com
[google][]
然后定义链接内容
[google]: http://google.com/
强调
Markdown 使用星号(*)和底线(_)作为标记强调字词的符号,被 * 或 _ 包围的字词会被转成用 <em> 标签包围,用两个* 或 _ 包起来的话,则会被转成 <strong>
*single asterisks*
_single underscores_
**double asterisks**
__double underscores__
** 注意 **
- 如果你的 * 和 _ 两边都有空白的话,它们就只会被当成普通的符号
- 如果要在文字前后直接插入普通的星号或底线,你可以用反斜线
代码
如果要标记一小段行内代码,你可以用反引号把它包起来(`)
如果要在代码区段内插入反引号,你可以用多个反引号来开启和结束代码区段
图片
Markdown 使用一种和链接很相似的语法来标记图片,同样也允许两种样式: 行内式和参考式。
- 行内式
![Alt text](/path/to/img.jpg)
- 参考式
![Alt text][id]
「id」是图片参考的名称,图片参考的定义方式则和链接参考一样
[id]: url/to/image "Optional title attribute"
** 注意 **
- Markdown 还没有办法指定图片的宽高,如果你需要的话,你可以使用普通的 <img> 标签。
java代码
使用如下格式写java代码
```java
public class Example {
public static void main(String[] args) {
}
}
```
表格
** 语法说明 **
- |、-、:之间的多余空格会被忽略,不影响布局。
- 默认标题栏居中对齐,内容居左对齐。
- -:表示内容和标题栏居右对齐,:-表示内容和标题栏居左对齐,:-:表示内容和标题栏居中对齐。
- 内容和|之间的多余空格会被忽略,每行第一个|和最后一个|可以省略,-的数量至少有一个。
| 左对齐标题 | 右对齐标题 | 居中对齐标题 |
| :------| ------: | :------: |
| 短文本 | 中等文本 | 稍微长一点的文本 |
| 稍微长一点的文本 | 短文本 | 中等文本 |
** 注意 **
- 表格的语句上一行必须为空行,不然表格不生效。
一个普通标题 | 一个普通标题 | 一个普通标题 |
---|---|---|
短文本 | 中等文本 | 稍微长一点的文本 |
稍微长一点的文本 | 短文本 | 中等文本 |