博客园中的Markdown编辑器没有预览功能,真是蛋疼啊
1.区块元素
一.换行
行末尾添加至少两个空格+换行
二.标题
- 标题前添加#号形式(多少个#号代表第几标题)
- 下方添加横线===(标题1)或者---(标题2)
例子
#标题1
对应显示
标题1
#标题2
对应显示
标题2
标题1
===
对应显示 (博客园中的Markdown不支持??)
标题1
三.引用
(1)区块引用可以嵌套
(2)引用的区块内也可以使用其他的 Markdown 语法,包括标题、列表、代码区块等
>注意:
>我是引用的内容
>####标题4
>>我是引用的引用(空一行就结束引用)。
对应显示
注意:
我是引用的内容标题4
我是引用的引用(空一行就结束引用)。
四.列表
- 有序列表(自然数 + 点 + 空格)
- 无序列表(无序列表使用星号、加号或是减号作为列表标记,后加一空格;二级列表:空格 + 减号 + 空格)(博客园中貌似需要添加Tab才能作为二级列表)
注意:列表每个项目可以包含多个段落,每个项目下的段落都必须缩进 4 个空格或是 1 个制表符
* 第一行
* 第一行二级列表1
* 第一行二级列表2
* 第二行
* 第三行
对应显示
- 第一行
- 第一行二级列表1
- 第一行二级列表2
- 第二行
- 第三行
五.代码区块
- 代码块前后分别用三个```括起来
- 分别在每一行头插入Tab,并且前后空出一行
例子
```
public static void Instance() {
//Method body
}
```
对应显示
public static void Instance() {
//Method body
}
六.分隔线
你可以在一行中用三个以上的星号、减号、底线来建立一个分隔线,行内不能有其他东西
***
对应显示
2.区段元素
一.链接
-
行内式
[链接描述文字(可见)](链接地址 "链接title")
[谷歌](www.google.com "链接到Google")
对应显示
-
参考式
[链接描述文字(可见)][链接标识] 文件任意地方写上对应链接: [链接标识]: 对应链接 "链接title"
需要注意:链接辨别标签可以有字母、数字、空白和标点符号,但是并不区分大小写
二.强调
-
斜体(前后添加一个*号)
-
加粗(前后添加两个*号)
-
斜体加粗(前后添加三个*号)
-
标亮(前后添加一个`)
**加粗** `标亮`
对应显示
加粗
标亮
三.代码
如果要标记一小段行内代码,你可以用反引号把它包起来(`)
我是一段代码' printline("abc") ' 结束打印
对应显示
我是一段代码printline("abc")
结束打印
四.图片
-
行内式
![图片描述性文字](图片相对地址 "Optional title")
对应显示
-
参考式
![图片描述性文字][图片参考标识] 文件其他处写上对应链接: [图片参考标识]: url/to/image "Optional title attribute"
3.其他
一.自动链接
Markdown 支持以比较简短的自动链接形式来处理网址和电子邮件信箱,只要是用尖括号包起来(博客园不支持电子邮件?)
<http://www.google.com/>
<address@example.com>
对应显示
http://www.google.com/
address@example.com
二.反斜杠
Markdown 可以利用反斜杠来插入一些在语法中有其它意义的符号
Markdown 支持以下这些符号前面加上反斜杠来帮助插入普通的符号:
反斜线
` 反引号
* 星号
_ 底线
{} 花括号
[] 方括号
() 括弧
# 井字号
+ 加号
- 减号
. 英文句点
! 惊叹号
三.锚点
(1)两个中括号把需要添加链接点的文字括起,后跟一对括号把锚点名括起,锚点名前需要添加#号
(2)锚点的写法如下
[锚点描述]<a name="headnode"></a>中间的headnode是指锚点名字
我在本文头部已经插入锚点,添加如下链接点,点击即可回到头部
[[去到锚点]](#headnode)
对应显示
[去到锚点]
四.关于Html
不在 Markdown 涵盖范围之内的HTML标签,都可以直接在文档里面用 HTML 撰写。不需要额外标注这是 HTML 或是 Markdown;只要直接加标签就可以了(在 HTML 区块标签间的 Markdown 格式语法将不会被处理)
需要注意
<div>、<table>、<pre>、<p>
等,一些标签,使用这些Html标签时前后需要空一行,且它们的开始标签与结尾标签不能用制表符或空格来缩进
如以下文本:
<table>
<tr>
<td>haha</td>
<td>zailai</td>
</tr>
</table>
在Markdown下显示如下:
haha | zailai |
参考资料
- Markdown wiki
- Markdown语法 英文版 中文版
- [Markdown 五分钟速成] (http://wiki.jikexueyuan.com/project/wiki-editors-guidelines/markdown.html)