markdown学习笔记
1. 标题
一个#
号 表示h1标题
例:# 这是h1标题
这是h1标题
两个#
号 表示h2标题
例:## 这是h2标题
这是h2标题
以此类推直至 h6标题 那就是6个#
号
例:###### 这是h6标题
这是h6标题
2. 特殊字符
在 HTML 文件中,有两个字符需要特殊处理: < 和 & 。如果你要使用它们,需使用它们的原型,< 和 & 。Markdown 让你可以自然地书写字符,需要转换的由它来处理好了。如果你使用的 & 字符是 HTML 字符实体的一部分,它会保留原状,否则它会被转换成 &
。
3. 反斜杠
Markdown 可以利用反斜杠来插入一些在语法中有其它意义的符号,例如:如果你想要用星号加在文字旁边的方式来做出强调效果(但不用 <em>
标签),你可以在星号的前面加上反斜杠:
其实文字前后加一个*
号或者_
,是将文字转为斜体,加入两个的话才是加粗。
*literal asterisks*
literal asterisks
Markdown 支持以下这些符号前面加上反斜杠来帮助插入普通的符号:
\ 反斜线
` 反引号
- 星号
_ 底线
{} 花括号
[] 方括号
() 括弧
# 井字号
- 加号
- 减号
. 英文句点
! 惊叹号
4. 代码表示
行内代码用两个 ``
符号括起来。
例:`console.log(“犯我德邦者,虽远必诛!”);`
console.log("犯我德邦者,虽远必诛!");
代码区块只要简单地缩进 4 个空格或是 1 个制表符就可以。不过要注意和上一行之间是隔着一行的。
例:
这是一个普通段落:
var canvas = document.getElementById(“canvas”);
这是一个普通段落:
var canvas = document.getElementById("canvas");
或者是使用`
|
|
5. 区块引用
在每一行文字前面都加入一个
<
符号,或者在整个段落的第一行加入<
号就可以建立一个区块引用。This is a blockquote with two paragraphs. Lorem ipsum dolor sit amet,
consectetuer adipiscing elit. Aliquam hendrerit mi posuere lectus.
Vestibulum enim wisi, viverra nec, fringilla in, laoreet vitae, risus.区块引用也可以嵌套,只需要在一个引用里面再加入
>
符号即可。例如:>>
This is nested blockquote. 当然其它的Markdown语法(列表、标题)也是可以放进去的。- This is the first level of quoting.
This is nested blockquote.
- Back to the first level.
6. 列表
Markdown 支持有序列表和无序列表。
无序列表使用*
、+
或是-
作为列表标记,有序列表用数字 + 英文点 + 空格 1. 2. 3.
表示有序列表
- 安妮
- 布兰德
- 亚索
7. 分割线
你可以在一行中用三个以上的星号、减号、底线来建立一个分隔线,行内不能有其他东西。你也可以在星号或是减号中间插入空格。下面每种写法都可以建立分隔线:
--------------------------------------------------------------------
***
- - -
* * *
___
8. 链接
Markdown 支持两种形式的链接语法: 行内式和参考式两种形式。要建立一个行内式的链接,只要在方块括号后面紧接着圆括号并插入网址链接即可,如果你还想要加上链接的 title 文字,只要在网址后面,用双引号、单引号或括号把 title 文字包起来即可,例如:This is [an example] (https://vampire618.github.io "vampire618") inline link.
This is an example inline link.
参考式的链接是在链接文字的括号后面再接上另一个方括号,而在第二个方括号里面要填入用以辨识链接的标记:
9. 插入图片
插入图片的形式和链接相似,只需在链接的基础上前方加一个!
![alttext] (http://images.cnitblog.com/blog/404392/201501/122257231047591.jpg)
Alt text
为如果图片无法显示时显示的文字;/path/to/img.jpg
为图片所在路径;Optional title
为显示标题。显示效果为在你将鼠标放到图片上后,会显示一个小框提示,提示的内容就是Optional title
里的内容。
例:
[参考资料]
- AntLog,Markdown你只需要掌握这几个 http://www.cnblogs.com/crazyant007/p/4220066.html
- yonghz, Markdown基本语法 https://github.com/younghz/Markdown
- riku, Markdown语法简体中文版 http://wowubuntu.com/markdown/