
Markdown是什么
Markdown是一种网络书写语言,兼容HTML但比HTML简单,
没有很多标签或者格式指令,可以直接以纯文本形式书写或者发布。
Markdown精挑细选了一些语法,其宗旨是易读易写。
可以体验一下在线的Markdown编辑器,如mahua在线Markdown。
基础语法
基础语法指官方版本Markdown支持的语法,GFM(Github Flavored Markdown)是github对Markdown语法的一些扩展。
1. 标题
开头的最后一个#
与标题之间必须有空格。

文字格式
符号与文字之间不能有空格。
引用’>’后的空格不能少, 引用行之后要空一行,否则之后的行都算是引用了。
1 | *This text will be italic* |
效果:
This text will be italic
This will also be italic
This text will be bold
This will also be bold
You can combine them
This is quote
This is quote’s quote
This is strikethrough,only for GFM.
列表 List
1. 无序列表 Unordered List
*
+
-
之后的空格不能少。
对嵌套列表,符号之后和之前的空格都不能少。
1 | * One |
效果:
- One
- Two
- Two Point One
- Two Point Two
- One
- Two
- Two Point One
- Two Point Two
- Three
链接 Link
文字链接
" "
里的内容可省略。
1 | https://wuchenxu.com -automatic! |
https://wuchenxu.com -automatic!
blog
图片链接
设置大小对齐,需要使用HTML, " "
可以省略。
1 |  |
图片嵌入超链接
1 | [](http://www.github.com "link to github") |
索引链接
^1
^2
可以是任意字符。
1 | [blog][^1] |
脚标
^ref
可以是任意字符。
1 | Ref[^ref] |
Ref[^ref]
[^ref]: your-link
代码 Code
`code`
code
```
if (isOK)
{
return true;
}
```
1 | if (isOK) |
页内链接Anchor
markdown目录
1 | 1.标题 |
html标签
1 | 1. 先定义一个锚(id) |
分割线
三个或者更过的-
或者*
,必须单独成行,可以有空格
1 | - - - |
hello
GFM语法
GFM(Github Flavored Markdown)是github对Markdown语法的一些扩展,官方版本的Markdown不支持以下语法。
表格 Table
官方版本的Markdown语法是不支持表格的,由于兼容HTML,可以使用<table>
标签来表示table。但是,有一些Markdown的语法扩展支持简单的表格(Simple Table)。
如Markdown Here,Github支持简单表格,推荐使用table generator来生成表格。
GFM的语法很简单,不支持行或者列的合并,不支持一个单元格的多行文字。
第一行是标题,第二行是固定的-
,冒号:
是来表示对齐方式。表格前或后必须有空行
.
1 | | Tables | Are | Cool | |
效果:
Tables | Are | Cool |
---|---|---|
col 1 is | left-aligned | $1600 |
col 2 is | centered | $12 |
col 3 is | right-aligned | $1 |
语法高亮 Syntax Highlighting
```javascript
function fancyAlert(arg) {
if(arg) {
$.facebox({div:’#foo’})
}
}
```
1 | function fancyAlert(arg) { |
任务列表 Task List
1 | - [x] This is a complete item |
- This is a complete item
- task 1
- task 2
- This is an incomplete item
表情 Emoji
体验一下2015牛津年度英语单词 笑cry
1 | :joy: |
:joy:
进阶
科技写作用Markdown+R 可以生成各种公式图片图表。
Reference: