下面,我要开始学习Markdown了:
一、什么是Markdown
Markdown是一种轻量级的标记语言,通过简单的标记语法可以使普通文本具有一定的格式。
二、简单的例子
作为程序员,每当接触新的东西都要先写个Demo试试。
我们可以用Markdown对文字进行**加粗**、*加斜*,也可以添加一个链接到[我的主页](http://www.jianshu.com/users/5a2675fba15e/latest_articles)。
我们可以用Markdown对文字进行加粗、加斜,也可以添加一个链接到我的主页。
三、Markdown语法
下面列出Markdown的一些常用语法:
标题(Header)
使用连续的#
标注标题
# HTML中标题
## HTML中标题
... ...
###### HTML中标题
强调(Emphasis)
使用*
、_
、**
、__
标注强调。如下:
*单星号*
_单下划线_
**双星号**
__双下划线__
_我们可以**组合使用**下划线和星号_
产生如下效果:
单星号,
单下划线,
双星号,
双下划线,
我们可以组合使用下划线和星号
当然,也有删除线,使用~~进行书写:
~~双波浪线~~
得到效果如下:
双波浪线
无序列表(Unordered Lists)
使用*
构造无序列表:
* item 1
* item 2
产生如下列表:
- item 1
- item 2
使用+
构造无序列表:
+ item 1
+ item 2
产生如下列表:
- item 1
- item 2
使用-
构造无序列表:
- item 1
- item 2
产生如下列表:
- item 1
- item 2
可以看出使用*
、+
、-
效果是相同的。
有序列表(Ordered Lists)
使用连续数字构造有序列表:
1. item 1
2. item 2
产生如下列表:
- item 1
- item 2
使用非连续数字构造有序列表:
3. item 1
8. item 2
产生如下列表:
- item 1
- item 2
使用 http://dillinger.io/ 时,构造有序列表时会以第一个数字起始生成连续的列表序号。而使用都是以1开始生成列表序号。
图片(Image)
图片有两种风格:内联风格 和 引用风格
内联风格为:![Alt Text](url "title")
,其中 title 可选。
![我的头像](http://upload-images.jianshu.io/upload_images/3834372-5179e540180de8c0.JPG?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240 "doggy")
得到下面的图片:
引用风格为:
[Alt Text][id]
[id]: url
![比你优秀的人都在努力][3]
[3]: http://upload-images.jianshu.io/upload_images/3834372-f300be125b18286e.jpg?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240
得到图片:
链接(Link)
链接也有两种风格:内联风格 和 引用风格
内联风格为:[Text](url)
[我的主页](http://www.jianshu.com/users/5a2675fba15e/latest_articles)
得到下面的链接:
我的主页
引用风格为:
[Text][id]
[id]: url
[GitHub][1]
[][2]
[卓越女生][girl]
[1]: https://github.com/
[2]: http://www.jianshu.com/
[girl]: https://bbs.excellence-girls.org/
对得到下面的地址链接:
GitHub
卓越女生
注意: 定义的名字可以包含字母、数字、空格和符号,但它不是大小写敏感的。
区块引用(Blockquotes)
区块引用使用>
表示:
> this is a block quote.
得到下面的结果:
this is a block quote.
行内代码(Inline code)
行内代码,使用反引号进行书写,例如:int count = 0;
代码块(Code block)
使用 ```+语言类型 书写代码块,其中的语言类型可选。代码块中的Markdown语法是不被解析的。
public class Main {
public void static main(String[] args) {
System.out.println("this is java code.");
}
}
水平线(Horizontal Line)
在一行里输入三个以上的星号或下划线(-
或*
)来插入一个水平线:
---
***
相应地,会产生下面的水平线:
表格(Tables)
表格的书写相对比较困难:
| left | center | right |
| ---------- |:----------:| ----------:|
| left-aligned | center-aligned | right-aligned |
得到如下表格:
left | center | right |
---|---|---|
left-aligned | center-aligned | right-aligned |
转义字符(Backslash escapes)
Markdown允许你对Markdown格式语法里面有特殊意义的字符做转义来输出他们本身:
\ backslash 反斜线
` backtick 反引号
* asterisk 星号
_ underscore 下划线
{} curly braces 花括号
[] square brackets 方括号
() parentheses 圆括号
# hash mark 井号
+ plus sign 加号
- minus sign (hyphen) 减号(连字符)
. dot 句点
! exclamation mark 感叹号
总结
Markdown基本语法已经学习完毕,使用时若有疑问,可以查看Markdown 语法说明进行查阅,配合工具能够达到更好的效果。