Markdown 语法指南

· 黑科技

认识 Markdown

Markdown 是一种用来写作的轻量级「标记语言」，它用简洁的语法代替排版，而不像一般我们用的字处理软件 Word 或 Pages 有大量的排版、字体设置。它使我们专心于码字，用「标记」语法，来代替常见的排版格式。例如此文从内容到格式，甚至插图，键盘就可以通通搞定了。目前来看，支持 Markdown 语法的编辑器有很多，包括很多网站也支持了 Markdown 的文字录入。Markdown 从写作到完成，导出格式随心所欲，你可以导出 HTML 格式的文件用来网站发布，也可以十分方便的导出 PDF 格式。

Markdown 的优点

  • 页面内容可读性强，简洁直观。
  • 纯文本，兼容性强，几乎任何文本编辑器都可打开。
  • 格式转换简便，轻松的导出HTML、PDF、.md等多种格式文件。
  • 不需太过于关心页面排版，只需关注内容。

Markdown 官方文档

创始人 John Gruber 的 Markdown 语法说明

换行符

在Markdown语法中，换行需要敲两个回车键，即在两段文本之间添加一个空行来达到换行的效果。

敲一个回车键

这是第一个段落
这是第二个段落

上面的写法在编辑器中显示是两行，但是在Macdown预览效果发现，他们还是在同一行，只是两个段落中间多出来一个空格。

这时我们在两行中间多敲一个回车键就能达到换行的效果

敲两个回车键键的效果：

这是第一个段落

这时第二个段落

有同学发现，我本来只是想让同一句话换个行显示而已，你这中间还多出来一空行，不够美观。能不能中间没有留白的空行，但是也能实现换行的效果尼？当然办法总是有的，下面就介绍第二种换行方式。

另一种方式实现换行的方式，两个段落之间没有空行

官方解释：To force a line break, put two spaces and a newline (return) at the end of the line.

在同一段落中，在需要换行的字符后敲两个空格，再敲回车键就能达到同一段落换行的效果

例如这样：

这是第一个段落
这时第二个段落

强调

在Markdown语法中，想要着重强调某一部分内容时，可以使用*或者是_来包裹要着重强调的内容。**或__表示字体加粗，*或_表示字体斜体，（个人推荐使用*）

这里的内容强调分两种语法，一种是字体加粗强调，另一种是为斜体强调

  1. 加粗（可以使用快捷键生成加粗符号：Command+b）
  • 方式1：这是字体加粗强调
  • 方式2：__这是字体加粗强调__
  1. 斜体（可以使用快捷键生成斜体符号：Command+i）
  • 方式1：这是斜体强调
  • 方式2：_这是斜体强调_

标题

在Markdown语法中，添加标题使用#，就会有标题加粗的效果出现。标题分为六个等级，即1个#代表一级标题，2个#代表二级标题，直到六级标题。

Header 1

Header 2

Header 3

Header 4

Header 5
Header 6

URL链接

在写自己的博客中，经常有需求要跳转到某一个网页或者邮件。这时需要使用link链接。link链接方式分为内联(Inline)和外部引用(Reference)
  • Inline

将邮箱地址包裹在<>内部，就形成了可以点击的邮箱地址: mailto:wormholestack@outlook.com

将网页url包裹在<>内部，就形成了可以点击访问的网页地址: http://www.wormholestack.com

自定义网页链接的标题[标题](链接): Ryan Blog

  • Reference (外部引用的好处可以在整个文章中重复引用网页地址或者图片地址而不需要多些拷贝同一个url)

Make a link [a link][arbitrary_id]

[like this][] [like this][]

引用图片

Markdown中引用图片资源同样也是分为内联(Inline)和外部引用(Reference)

  • Inline

    语法：

![Alt Image Text](图片地址)

使用方式：

Alt Image Text

  • Reference

语法

![Alt Image Text][image-id]

[image-id]: https://wormhole-img-1300857730.cos.ap-nanjing.myqcloud.com/%20dailyLife/avatar.jpeg

使用方式：

Alt Image Text

列表

Markdown语法中，列表分为三类：有序列表、无序列表、嵌套列表

  • 有序列表

  1. 列表1
  2. 列表2
  3. 列表3

  • 无序列表(无序列表中，*、+、-效果一样，个人推荐使用*)

  • 列表1
  • 列表2
  • 列表4
  • 列表5
  • 列表7
  • 列表8

  • 缩进层次嵌套列表

    • 这是一个嵌套列表

      1. 列表1
      2. 列表2
      3. 列表3

引用

Markdown语法中，使用>表示引用，引用名人名言或者是别人的一段文本等。
"三天不学习，赶不上刘少奇。" - 毛泽东

当然引用也可以嵌套使用的

这时一级引用

这时二级引用

这时三级引用
还是三级引用

二级引用

一级引用

引用也可以和其他的markdown语法混合使用

这是一级引用

这是二级引用

  • 这是三级引用
  • 还是三级引用
  • 还是三级标题
  • 还是三级标题

二级引用

一级引用

InlineCode

内嵌文本，当我们想让某一文本内容内嵌在边框内，我们可以使用一对反引号包裹内容:内容

使用方式：

内容本身不包含反引号

  • Inline code

内容本身包含反引号。当文本内容中正好包含有反引号，这时需要使用空格隔开：

  • code has `backticks`
  • ``Code with `backticks` ``

BlockCode

当我们敲4个空格键或者是一个tab键，这样就形成一个代码块区域。不推荐使用

使用方式：

print('This is a code block')
print('The block must be preceded by a blank line')
print('Then indent at least 4 spaces or 1 tab')
print('Nesting does nothing. Your code is displayed Literally')

CodeBlock

对于程序员来说，很多时候我们写技术博客都需要贴上自己的代码来给读者讲解，这时就用到了代码引用语法：三个反引号Code或者三个波浪号~Code~。
  • 方式1
render() {
        const dataArr = this.state.dataSource
        return (
          <ListView
            style={styles.listStyle}
            dataSource={dataArr}
            renderRow={this.renderRow}
            renderSeparator={() => this._renderSeparator()}
          />
    )
  }
  • 方式2
render() {
        const dataArr = this.state.dataSource
        return (
          <ListView
            style={styles.listStyle}
            dataSource={dataArr}
            renderRow={this.renderRow}
            renderSeparator={() => this._renderSeparator()}
          />
    )
  }

分割线

当我们想对文章的某些内容做上下分割，这时我们可以使用分割线语法：***或---
  • 粗线

or

  • 细线(细线只需一个或者两个-)

-

or

--

表格

表格的使用肯定我们每一位同学都不陌生，因为我们经常使用Excel表格来展示各种数据报表。很庆幸Markdown同样也支持表格制作，而且使用方式很简单。表格由行与列组成，这里只需要注意表格的内容对齐方式即可。

没有设置对齐方式

First HeaderSecond Header
Content CellContent Cell
Content CellContent Cell

中间表格对齐

Left AlignedCenter AlignedRight Aligned
col 3 issome wordy text$1600
col 2 iscentered$12
zebra stripesare neat$1

这里需要注意：表格的左边和右边的|可以省略不需要使用，表格左右两边加上|主要基于美观考虑，表格的对齐方式仅仅取决于:

锚点

在写文章时，有时候我们有这样的需求，从文章的某一个位置直接跳转到指定的另一个位置，这时使用到a标签的锚点语法。

使用方式：

在待跳转到的位置上添加一行：<a name="markdown-anchor"></a>

[*Markdown高级用法：* 跳转到Blog链接处](#markdown-anchor)：通过name就可以找到指定的位置

Markdown高级用法： 跳转到Blog链接处

del标签

内容中间添加一条横线: <del>xxx</del>
First HeaderSecond Header
Content CellContent Cell
Content CellContent Cell

u标签

内容底部添加一条横线: <u>xxx</u>
First HeaderSecond Header
Content CellContent Cell
Content CellContent Cell

mark标签

内容颜色高亮处理: <mark>xxx</mark>
First HeaderSecond Header
Content CellContent Cell
Content CellContent Cell

font标签

设置文本的字体颜色: <font color=Red>xxx</font>

修改文本的字体颜色为红色

总结

强烈建议读者们认真浏览的这篇文章后，自己使用Markdown写一篇文章，体会一下Markdown语法的优雅之处！

本文链接：

https://www.wormholestack.com/archives/791/
1 + 6 =
快来做第一个评论的人吧~