Markdown简介

简介

markdown是标记语言,通过标记语法使普通文本具有一定格式。

具有衍生版本(eg:表格、脚本、内嵌HTML),它们能让markdown转换成更多的格式,例如:LaTeX、Docbook

markdown中增强版中比较有名的是Markdown Extra、MultiMarkdown、Maruku等。这些衍生版本要么基于工具,eg:Pandoc;要么基于GitHub和Wikipedia,在语法上基本兼容。

markdown编辑器推荐

在线版

dillinger(来自国外、不够稳定)——支持md、html、pdf文件导出
StackEdit——对中文支持不好
MaHua——小众软件推荐、界面有点简陋
简书(博客平台)——需要注册帐号后编辑、每几秒钟便会自动存入一个备份、直接从本地拖入照片生成链接
马克飞象——付费软件

windows

MarkdownPad——左右栏分割,可以实时看到HTML格式的Markdown文档
MarkPad——开源的
Smark——开源软件
Miu——模仿mou、小众推荐、官网无法打开 百度云下载、界面美观、功能不成熟

OSX(Mac)

Mou——Mac下杰出的编辑器、提供语法高亮、在线预览、同步滚动、全屏模式、自动匹配、允许自定义主题、支持CSS HTML PDF导出
MacDown——开源且免费
Ulysses——付费的、支持OSX、iPad、堪称佼佼者
iA Writer——未优化中文显示
MWeb——专业、UI漂亮、主题可选、支持发布到wp、blogger、tumblr等多个博客

跨平台

Cmd Markdown——工具和博客平台兼顾的产品
小书匠编辑器——全平台覆盖
FarBox——免费、在本地编辑后自动同步到个人博客
Sublime Text 2——付费(会时不时跳出注册提醒)、界面简约大方、定位专业、需要安装插件才可以编辑markdown
Atom——github出的编辑器、功能强大、可以编写代码还可以编辑markdown、并且支持markdown预览(按ctrl+shift+m)
Retext——用python开发的、跨平台、支持导出PDF、ODT和HTML以及纯文本,支持即时预览、网页生成、语法高亮、全屏模式、可导出文件到google docs等。

Markdown语法

段落

第一段

第二段:要跟第一段之间隔一个空行,才会形成第二段 这样在前面加入空格,只会解析为一个空格(后有两个空格)
但是像这样,上一段话后有两个空格,并且后面文字换行写,则会解析为换行

粗体 斜体

这是斜体 这也是斜体

这是粗体

这是粗体加斜体

删除线

删除线

该MarkdownPad不支持删除线,它也不是经典markdown中的要素

标题(6级标题,可以省略后面的)

可以选择性地「闭合」标题,在行尾加上 #,纯粹只是美观用的。
行尾的 # 数量也不用和开头一样(行首的井字符数量决定标题的阶数)

1
2
3
4
5
6
###### 这是H6
##### 这是H5
#### 这是H4
### 这是H3
## 这是H2
# 这是H1

H1和H2也可以采用:文本下方添加底线。(底线的长短不要求)

1
2
3
4
H1也可以这样
=====
H2也可以这样
---

引用

通常在首行加上大于号来添加引用内容

引用可以嵌套引用

1
># 还可以嵌套其他格式

列表

无序列表:用+或者-或者星号来写无序列表,注意这些符号后要加空格

  • 111
  • 222
  • 333

  • aaa
  • bbb
  • ccc

  • qqq
  • www
  • eee

有序列表:用数字接着一个英文句点,英文句点后要有空格

并且列表前面的数字是几,并不会影响显示。比如:以下两种显示相同

  1. ppppppp
  2. ooooooo
  3. iiiiiii

  1. oippop
  2. uoipkinl
  3. hojojoko

内联代码???

用单引号标记内联代码,会解析成html标签。这样,代码中的& < >符号都会自动转义

‘function fn(){
var a = ‘7’;
if(i>’5’){
return true;
}
}’

代码区域(两种方式)???

第一种方式:在代码首行空4个空格

<html>
    <head>
        <title>HTML代码</title>
    </head>
    <body></body>
</html>

第二种方式:github的风格——代码段的前后都用三个单引号独占一行来标记。目前主流编辑器都支持这种风格

github格式只能一行显示??

1
2
3
4
5
6
<html>
<head>
<title>HTML标题</title>
</head>
<body>HTML内容</body>
</html>

分隔线

用三个以上的星号、减号、底线来建立一个分隔线,独占一行




可以在三个以上的星号、减号、底线里添加任意的空格




链接

行内式

这是百度链接

这是一个带着title的百度链接

会被解释为
an example
an example

非行内式(两句的顺序不限制)

百度链接

图像

行内式

图像alt内容
图像alt内容

非行内式
同上

自动链接

如果链接的地址和名称一样的时候,可以简写

http://www.baidu.com

相当于下面写法

http://www.baidu.com

转义

以下字符,要在前面插入反斜杠\,才能将字符原样输出

\ 反斜线

` 反引号

* 星号

_ 底线

{} 花括号

[] 方括号

() 括弧

# 井字号

+ 加号

- 减号

. 英文句点

! 惊叹号

表格???

表格是github风格独有的语法

第一行的表格头部可以没有,但是第二行必须有。第二行的冒号代表居左居中还是居右;不加冒号,默认居左

item value qty
a 1 5
b 2 6

或者用html标签来构造表格

<table>
<thead>
<tr>
<th align="left">Item</th>
<th align="right">Value</th>
<th align="center">Qty</th>
</tr>
</thead>
<tbody>
<tr>
<td align="left">Computer</td>
<td align="right">$1600</td>
<td align="center">5</td>
</tr>
<tr>
<td align="left">Phone</td>
<td align="right">$12</td>
<td align="center">12</td>
</tr>
<tr>
<td align="left">Pipe</td>
<td align="right">$1</td>
<td align="center">234</td>
</tr>
</tbody>
</table>

html代码

当html代码前面没有四个空格,则会解析html代码;若有4个空格或者有三个单引号括着,则不解析代码,会直接显示代码