手记

Markdown 易学易用 使用笔记

What,Markdown是什么

Markdown 是一种轻量级标记语言,创始人为约翰·格鲁伯(John Gruber)。Markdown 是一个 Web 上使用的文本到HTML的转换工具,可以通过简单、易读易写的文本格式生成结构化的HTML文档。目前 github、Stackoverflow 等网站均支持这种格式。

Why,Markdown有什么好处
  • 专注内容
    让你专注于文字而不是排版。
  • 易学易用
    Markdown 的标记语法有极好的可读性,几分钟就可以简单上手。
  • 兼容性强
    纯文本,可以用所有文本编辑器打开。
  • 格式转换方便
    Markdown 的文本你可以轻松转换为 html、电子书等。
  • 功能强大
    可以绘制表格、UML图等
How,Markdown怎么用

段落

一个段落是由一个以上的连续的文本行组成,而一个以上的空行则会划分出不同的段落(空行的定义是显示上看起来像是空行,就被视为空行,例如有一行只有空白和 tab,那该行也会被视为空行),一般的段落不需要用空白或换行缩进。

标题

Markdown 支持两种标题的语法,类 Setext 和类 atx 形式。
类 Setext 形式是用底线的形式,利用 = (最高阶标题)和 - (第二阶标题),例如:

一级标题
=========

二级标题
-------------

任何数量的 = 和 - 都可以有效果。

类 Atx 形式则是在行首插入 1 到 6 个 # ,对应到标题 1 到 6 阶,例如:

#    一号标题

###    三号标题

#####    五号标题

你可以选择性地「闭合」类 atx 样式的标题,这纯粹只是美观用的,若是觉得这样看起来比较舒适,你就可以在行尾加上 #,而行尾的 # 数量也不用和开头一样(行首的井字符数量决定标题的阶数):

# 这是 H1 #

## 这是 H2 ##

### 这是 H3 ######

强调

Markdown 使用星号()和底线(_)作为标记强调字词的符号,被 包围的字词会被转成用 <em> 标签包围,用两个 * 或 包起来的话,则会被转成 <strong>,例如:

*斜体*                //ctrl + i

_斜体_              

**粗体**             //ctrl + b

__粗体__

~~添加删除线~~

引用

引用只需要在被引用的内容段落开头加上右尖括号('>')即可。你可以选择只在开头加一个。也可以在每行前面都加一个,效果是一样的。

> 这一整段的内容都会作为一个HTML的引用元素。
引用元素是会自动优化排版的(reflowable,可回流)。
你可以任意地将引用的内容包含进来,然后所有这些都会
被解析成为单独一个引用元素。

引用可以嵌套。如果要在一个引用里插入一个引用,可以用两个('>')开头。依此类推,根据嵌套层次加相应数量的符号。

>这是一个引用。这是第一行
这是第二行。

>>这是一个嵌套的引用。这是第一行。
这是第二行
>
>外层引用的第三行。前面需要一个视觉上的空行表示内层嵌套的结束,空行前面的('>')可以有可以没有。

列表

Markdown 支持有序列表和无序列表。
无序列表使用星号、加号或是减号作为列表标记(ctrl + U):

* Hello
* Hi
* Are you OK?

等同于

+ Hello
+ Hi
+ Are you OK?

也等同于

- Hello
- Hi
- Are you OK?

代码

如果要标记一小段行内代码,你可以用反引号把它包起来(`),例如:
this is a inline code .
如果要建立一个已经格式化好的代码区块,只要每行都缩进 4 个空格或是一个 tab 就可以了,而 &、< 和 > 也一样会自动转成 HTML 实体。

如果要标记一块代码,你可以用多个反引号来开启和结束代码区段:

```
There is a block code (\`) here.
block code
```
There is a block code here.
block code

链接

Markdown 支持两种形式的链接语法: 行内式和参考式两种形式。
不管是哪一种,链接文字都是用 [方括号] 来标记。

要建立一个行内式的链接,只要在方块括号后面紧接着圆括号并插入网址链接即可,如果你还想要加上链接的 title 文字,只要在网址后面,用双引号把 title 文字包起来即可,例如:

This is [an example](http://example.com/ "Title") inline link.

[This link](http://example.net/) has no title attribute.

This is an example inline link.
This link has no title attribute.

图片

![Alt text](/static/img/common/logo.png?t=1)

![Alt text](/static/img/common/logo.png?t=1 "Optional title")


表格

|姓名|性别|年龄|
|--|---|---|
|da|sd|da|
姓名 性别 年龄
da sd da

反斜杠

Markdown 可以利用反斜杠来插入一些在语法中有其它意义的符号,例如:如果你想要用星号加在文字旁边的方式来做出强调效果(但不用 <em> 标签),你可以在星号的前面加上反斜杠:

 \*literal asterisks\*

Markdown 支持以下这些符号前面加上反斜杠来帮助插入普通的符号:

\   反斜线
`   反引号
*   星号
_   底线
{}  花括号
[]  方括号
()  括弧
#   井字号
+   加号
-   减号
.   英文句点
!   惊叹号

分割线

分割线的语法只需要另起一行,连续输入三个星号 *** 即可。

参考

http://www.markdown.cn/

18人推荐
随时随地看视频
慕课网APP