Markdown入门
参考:Markdown语法说明
1. Markdown的标题
Markdown 支持两种标题的语法,类 Setext 和类 atx 形式。
类 Setext 形式是用底线的形式,利用 =
(最高阶标题)和 -
(第二阶标题),例如:
This is an H1
==============
This is an H1
This is an H2
-----------------------
This is an H2
类 Atx 形式则是在行首插入 1 到 6 个 #
,对应到标题 1 到 6 阶,例如:
# 这是H1
这是H1
# 这是H1
这是h2
###### 这是h6
这是h6
2. 列表
markdown支持有序列表和无序列表
无序列表使用星号、加号或是减号作为列表标记:
* 北京
* 上海
* 深圳
* 广州
- 北京
- 上海
- 深圳
- 广州
- 成都
- 武汉
- 合肥
有序列表则使用数字接着一个英文句点:
1. 杭州
2. 苏州
3. 无锡
- 杭州
- 苏州
无锡
Android
- Java
- 材料化工
Lorem ipsum dolor sit amet, consectetuer adipiscing elit.
Aliquam hendrerit mi posuere lectus.
Vestibulum enim wisi,viverra nec, fringilla in, laoreet vitae, risus.塞纳河畔,左岸的咖啡,我手一杯品尝你的美~
微笑在天上飞,你说你有点难追,想让我知难而退Donec sit amet nisl.
Aliquam semper ipsum sit amet velit.
Suspendisse id sem consectetuer libero luctus adipiscing.-列表项包含一个列表区块
public String(char value[]) { this.value = Arrays.copyOf(value, value.length); }
2017. 这是一个伟大的开始(在行首出现数字-句点-空白,要避免这样的状况,你可以在句点前面加上反斜杠“\”)
3. 代码区域
这是一个普通区域
这是一个代码区域
String类的构造方法有:
public String() {
this.value = "".value;
}
public String(String original) {
this.value = original.value;
this.hash = original.hash;
}
public String(char value[]) {
this.value = Arrays.copyOf(value, value.length);
}
在代码区块里面, & 、 < 和 > 会自动转成 HTML 实体,这样的方式让你非常容易使用 Markdown 插入范例用的 HTML 原始码,只需要复制贴上,再加上缩进就可以了,剩下的 Markdown 都会帮你处理,例如:
© 2017 YaoPaine
<div class=”footer”>
© 2004 Foo Corporation
</div>
4. 分割线
* * *
***
*****
- - -
---------------------------------------
5. 链接
Markdown 支持两种形式的链接语法: 行内式和参考式两种形式。
This is an example inline link
This link has no title attribute.
.图片
Markdown 使用一种和链接很相似的语法来标记图片,同样也允许两种样式: 行内式和参考式。
行内式的图片语法看起来像是:1
![Alt text](/path/to/img.jpg)
1
![Goolge plus](/path/to/img.jpg "Optional title")
详细叙述如下:
一个惊叹号 !
接着一个方括号,里面放上图片的替代文字
接着一个普通括号,里面放上图片的网址,最后还可以用引号包住并加上 选择性的 ‘title’ 文字。
参考式的图片语法则长得像这样:
![Alt text][id]
「id」是图片参考的名称,图片参考的定义方式则和连结参考一样:
[id]: url/to/image "Optional title attribute"
到目前为止, Markdown 还没有办法指定图片的宽高,如果你需要的话,你可以使用普通的 <img> 标签。
- 首先定义链接:
[react][link] - 定义链接内容 其格式为:[识别符]: URL ‘title’。
[link]: https://techchronos.com/wp-content/uploads/SszarkLabs/stack-icon/cywBkaGwkMeDAuJbSt1k.png “this is title”
[react][link]
. 其它
自动链接
Markdown 支持以比较简短的自动链接形式来处理网址和电子邮件信箱,只要是用尖括号包起来, Markdown 就会自动把它转成链接。一般网址的链接文字就和链接地址一样,例如:1
<yaopaine@outlook.com>
反斜杠
Markdown 可以利用反斜杠来插入一些在语法中有其它意义的符号,例如:如果你想要用星号加在文字旁边的方式来做出强调效果(但不用 标签),你可以在星号的前面加上反斜杠:
*已经习惯,不去阻止你,过好一阵子,你就会回来*
*已经习惯,不去阻止你,过好一阵子,你就会回来*
已经习惯,不去阻止你,过好一阵子,你就会回来
已经习惯,不去阻止你,过好一阵子,你就会回来Markdown 支持以下这些符号前面加上反斜杠来帮助插入普通的符号:
1
2
3
4
5
6
7
8
9
10
11
12\ 反斜线
` 反引号
* 星号
_ 底线
{} 花括号
[] 方括号
() 括弧
# 井字号
+ 加号
- 减号
. 英文句点
! 惊叹号