markdown语法

段落与换行

换行最好在前一段字符串后加两个空格
两行之间不管有多少空行,显示都是一个空行
唯一决定两行文字是否是段落的,就在于这两行文字之间是否有空行
段落也可以用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 使用一种和链接很相似的语法来标记图片,同样也允许两种样式: 行内式和参考式。

  1. 行内式
![Alt text](/path/to/img.jpg)
  1. 参考式
![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) {

  }
}
```

表格

** 语法说明 **

  • |、-、:之间的多余空格会被忽略,不影响布局。
  • 默认标题栏居中对齐,内容居左对齐。
  • -:表示内容和标题栏居右对齐,:-表示内容和标题栏居左对齐,:-:表示内容和标题栏居中对齐。
  • 内容和|之间的多余空格会被忽略,每行第一个|和最后一个|可以省略,-的数量至少有一个。

| 左对齐标题 | 右对齐标题 | 居中对齐标题 |
| :------| ------: | :------: |
| 短文本 | 中等文本 | 稍微长一点的文本 |
| 稍微长一点的文本 | 短文本 | 中等文本 |

** 注意 **

  • 表格的语句上一行必须为空行,不然表格不生效。
一个普通标题 一个普通标题 一个普通标题
短文本 中等文本 稍微长一点的文本
稍微长一点的文本 短文本 中等文本
發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章