美文网首页读书笔记
Markdown 简明语法

Markdown 简明语法

作者: 银之 | 来源:发表于2014-10-29 16:08 被阅读7718次

Markdown是一种轻量级的标记语言,语法简单,可以排出简洁的表现界面。

  • 支持表格、代码块、LaTeX数学公式、目录
  • 可以很方便的插入到 Gmail、Evernote
  • 很容易转为 HTML 、PDF 文件
  • 可以自定义 css 文件,写出更直观优雅的笔记

注:按照Markdown标准语法描述,如果你的 Markdown 文本未能正确显示,很可能是在标记符号和文本间忘了保留一个字符的空格

一、标题

# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题

效果:

一级标题

二级标题

三级标题

四级标题

五级标题
六级标题

二、列表

在 Markdown 中,只需要在文字前面加上+就可以转换为列表,也可以用*-

+ 文本
  • 文本

在文字前面加上 1. 2. 3. 这样的数字.空格可以生成序列表:

1. 文本1
2. 文本2
3. 文本3
  1. 文本1
  2. 文本2
  3. 文本3

三、链接和图片

在 Markdown 中,链接用 [显示文本](链接地址)的语法描述,例如:

[简书](http://jianshu.io)

可以用类似的语法描述图片(前面多了一个 ** !** ):

![](http://ww4.sinaimg.cn/bmiddle/aa397b7fjw1dzplsgpdw5j.jpg)

四、引用

> 我是被引用的内容 =w=

我是被引用的内容 =w=

五、加粗和斜体,删除线

**两个连续星号包围一段文本,就把这段加粗啦**
*两个单独星号包围一段文本,就让文本倾斜咯*
_或者用下划线来倾斜_
~~删除线~~

** 两个星号包围一段文本,就把这段加粗啦 **
两个单独星号包围一段文本,就让文本倾斜咯
或者用下划线来倾斜
删除线
这里需要注意,*也被用于描述列表,为区别开,倾斜中的 * 和文本间不能留有空格。

六、表格

dog | bird | cat 
----|:----:|----:
foo | foo | foo
bar | bar | bar
baz | baz | baz

绘制表格 需要在前后均保留一行空白。由-|-|- 的结构分割表头和表身,请注意上述代码中的:,控制了单列表格的对齐方向。(也可以用 | - | - | - | 的结构,显得更加整洁)

dog bird cat
foo foo foo
bar bar bar
baz baz baz

七、分页线和换行

---

三个以上的 -可以描绘一根分页线 (注意前后要空行)


不分段换行:行末加两个空格,直接回车
分段换行:两个或多个回车(用空行来换行)

八、代码块

行内代码用 `int sum = b + c`

这里用两个`将 int sum = b+c描述为一段将背景标红的行内代码。
行内代码用 ` int sum = b + c `
行内代码用 int sum = b + c 又被上下的 ``` 标记,变成一段灰色的代码块。
段前空一行,缩进4个空格,然后书写代码,也可以自动转为代码块。
此外,还可以自定义 css 文件,以 ```ruby 的开头描述“这是一段 ruby 代码”,不同的描述可以适配不同的高亮。( Raysonte代码高亮示例


进阶内容

下述内容并不经常用到,可以直接拉到页尾,看看扩展阅读或是推荐应用。

一、数学公式

 $\sum_{i=1}^n a_i=0$

这段描述了在行内嵌入公式 \sum_{i=1}^n a_i=0

$$\sum_{i=1}^n a_i=0$$

在两边再包围一对 $,可以嵌入一个数学公式块。

简书并不支持数学公式, Raysnote数学公式示例

二、HTML代码

在 Markdown 文本中可以直接书写 html 代码,这需要应用的支持(大部分应用都支持这一点,目前发现简书不支持)。区块元素 —— 比如<div>,<table>,<pre>,<p>必须在前后加上空行与其它内容区隔开,还要求它们的开始标签与结尾标签不能用制表符或空格来缩进。
请注意,在 HTML 区块标签间的 Markdown 格式语法将不会被处理,在HTML区段标签间则是有效的。

三、列表内的内容

1. 列表项目可以包含多个段落,每个项目下的段落必须缩进4个空格或是1个制表符:

  1. This is the first line.
    This is the second line.
  1. This is the third line.

2. 如果要在列表内放入引用,用>搭配缩进:

  • A list item with a blockquote:

    This is a blockquote

3. 要在列表内放代码块,该区块就要缩进两次:

  • A list
    print "Hello world!"

4. 1986. What a great season. 开头属于 数字 . 空格,会被翻译为列表:

  1. What a great season.

和 HTML中一样,可以在符号前加上\来转义

1986\. What a great season.

1986. What a great season.

5. 通过空格缩进来生成多层列表

通过空格缩进来生成多层列表

  • list
  • list1.1
    • list
      1. 列表1
      2. 列表2

推荐应用

||
---- |:----|:----
Cmd Markdown|据说是中文界最好的在线 Mark编辑器
简书|简书如何切换到 Markdown 编辑器
Raysnote|优雅美观好用的在线笔记,暂未提供导出功能
Markdown Here|浏览器插件,可以转换网页端邮件、Evernote内容
马克飞象|可以和印象笔记同步,¥78/年
MaHua|有导入导出的在线编辑器,非常漂亮

扩展阅读:
Markdown写作浅谈
Markdown中文语法手册

相关文章

网友评论

    本文标题:Markdown 简明语法

    本文链接:https://www.haomeiwen.com/subject/lvuvtttx.html