献给写作者的 Markdown 新手指南

Love The Way You Lie 2022-06-04 00:13 175阅读 0赞

# 献给写作者的 Markdown 新手指南 #

[「简书」][Link 1] 作为一款「写作软件」在诞生之初就支持了 Markdown，Markdown 是一种「电子邮件」风格的「标记语言」，我们强烈推荐所有写作者学习和掌握该语言。为什么？可以参考:

*  [『为什么作家应该用 Markdown 保存自己的文稿』][Markdown]。
 *  [『Markdown写作浅谈』][Markdown 1]

在此，我们总结 Markdown 的优点如下：

*  纯文本，所以兼容性极强，可以用所有文本编辑器打开。
 *  让你专注于文字而不是排版。
 *  格式转换方便，Markdown 的文本你可以轻松转换为 html、电子书等。
 *  Markdown 的标记语法有极好的可读性。

当然，我们既然如此推崇 Markdown ，也必定会教会你使用 Markdown ，这也是本文的目的所在。不过，虽然 [Markdown 的语法][Markdown 2]已经足够简单，但是现有的 Markdown 语法说明更多的是写给 web 从业者看的，对于很多写作者来说，学习起来效率很低，现在，我们特地为写作者量身定做本指南，从写作者的实际需求出发，介绍写作者真正实用的常用格式，深入浅出、图文并茂地让您迅速掌握 Markdown 语法。

为了使您更好地学习，我们建议您登录\[「简书」\]([http://www][http_www]. [jianshu.com][])，将您的编辑器切换至 Markdown 编辑器，新建一篇空白笔记，然后点击右上角的预览模式：

![431][]

此时，您的界面应当如下图所示，左侧为编辑区域，右侧为预览区域，您在左侧输入 Markdown 语法的文本，右侧会立即帮您呈现最终结果，好了，让我们开始学习吧~

![700][]

## 标题 ##

这是最为常用的格式，在平时常用的的文本编辑器中大多是这样实现的：输入文本、选中文本、设置标题格式。

而在 Markdown 中，你只需要在文本前面加上 `#` 即可，同理、你还可以增加二级标题、三级标题、四级标题、五级标题和六级标题，总共六级，只需要增加 `#` 即可，标题字号相应降低。例如：

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

注：`#` 和「一级标题」之间建议保留一个字符的空格，这是最标准的 Markdown 写法。

你可以你的编辑器中尝试输入这六级标题，可以参考下方的截图：

![700 1][]

一级标题至六级标题

## 列表 ##

列表格式也很常用，在 Markdown 中，你只需要在文字前面加上 `-` 就可以了，例如：

- 文本1
    - 文本2
    - 文本3

如果你希望有序列表，  
也可以在文字前面加上 `1.` `2.` `3.` 就可以了，例如：

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

注：`-`、`1.`和文本之间要保留一个字符的空格。

列表案例截图如下：

![700 2][]

<h2 id="picture"> 链接和图片</h2>

在 Markdown 中，插入链接不需要其他按钮，你只需要使用 `[显示文本](链接地址)` 这样的语法即可，例如：

[简书](http://www.jianshu.com)

在 Markdown 中，插入图片不需要其他按钮，你只需要使用 `![](图片链接地址)` 这样的语法即可，例如：

![](http://upload-images.jianshu.io/upload_images/259-0ad0d0bfc1c608b6.jpg?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)

注：插入图片的语法和链接的语法很像，只是前面多了一个 `！`。

插入链接和图片的案例截图：

![700 3][]

## 引用 ##

在我们写作的时候经常需要引用他人的文字，这个时候引用这个格式就很有必要了，在 Markdown 中，你只需要在你希望引用的文字前面加上 `>` 就好了，例如：

> 一盏灯， 一片昏黄； 一简书， 一杯淡茶。 守着那一份淡定， 品读属于自己的寂寞。 保持淡定， 才能欣赏到最美丽的风景！ 保持淡定， 人生从此不再寂寞。

注：`>` 和文本之间要保留一个字符的空格。

最终显示的就是：

引用的案例截图：

![700 4][]

## 粗体和斜体 ##

Markdown 的粗体和斜体也非常简单，用两个 `*` 包含一段文本就是粗体的语法，用一个 `*` 包含一段文本就是斜体的语法。例如：

*一盏灯*， 一片昏黄；**一简书**， 一杯淡茶。 守着那一份淡定， 品读属于自己的寂寞。 保持淡定， 才能欣赏到最美丽的风景！ 保持淡定， 人生从此不再寂寞。

最终显示的就是下文，其中「一盏灯」是斜体，「一简书」是粗体：

一盏灯， 一片昏黄；一简书， 一杯淡茶。 守着那一份淡定， 品读属于自己的寂寞。 保持淡定， 才能欣赏到最美丽的风景！ 保持淡定， 人生从此不再寂寞。

粗体和斜体的案例截图：

![700 5][]

## 代码引用 ##

需要引用代码时，如果引用的语句只有一段，不分行，可以用 \` 将语句包起来。  
如果引用的语句为多行，可以将\`\`\`置于这段代码的首行和末行。  
代码引用的案例截图：

![700 6][]

## 表格 ##

相关代码：

| Tables        | Are           | Cool  |
    | ------------- |:-------------:| -----:|
    | col 3 is      | right-aligned | $1600 |
    | col 2 is      | centered      |   $12 |
    | zebra stripes | are neat      |    $1 |

显示效果：

<table style="border-collapse:collapse; border-spacing:0px; background-color:transparent; width:620px; margin-bottom:20px; border-top:1px solid rgb(221,221,221); border-right:1px solid rgb(221,221,221); border-bottom:1px solid rgb(221,221,221); border-left:none; word-break:normal"> 
 <thead style=""> 
  <tr style=""> 
   <th style="padding:8px; border:1px solid rgb(221,221,221); line-height:20px; vertical-align:middle"> Tables</th> 
   <th style="padding:8px; text-align:center; border:1px solid rgb(221,221,221); line-height:20px; vertical-align:middle"> Are</th> 
   <th style="padding:8px; text-align:right; border:1px solid rgb(221,221,221); line-height:20px; vertical-align:middle"> Cool</th> 
  </tr> 
 </thead> 
 <tbody style=""> 
  <tr style=""> 
   <td style="padding:8px; border:1px solid rgb(221,221,221); line-height:20px; vertical-align:middle"> col 3 is</td> 
   <td style="padding:8px; border:1px solid rgb(221,221,221); line-height:20px; vertical-align:middle; text-align:center"> right-aligned</td> 
   <td style="padding:8px; border:1px solid rgb(221,221,221); line-height:20px; vertical-align:middle; text-align:right"> $1600</td> 
  </tr> 
  <tr style=""> 
   <td style="padding:8px; border:1px solid rgb(221,221,221); line-height:20px; vertical-align:middle"> col 2 is</td> 
   <td style="padding:8px; border:1px solid rgb(221,221,221); line-height:20px; vertical-align:middle; text-align:center"> centered</td> 
   <td style="padding:8px; border:1px solid rgb(221,221,221); line-height:20px; vertical-align:middle; text-align:right"> $12</td> 
  </tr> 
  <tr style=""> 
   <td style="padding:8px; border:1px solid rgb(221,221,221); line-height:20px; vertical-align:middle"> zebra stripes</td> 
   <td style="padding:8px; border:1px solid rgb(221,221,221); line-height:20px; vertical-align:middle; text-align:center"> are neat</td> 
   <td style="padding:8px; border:1px solid rgb(221,221,221); line-height:20px; vertical-align:middle; text-align:right"> $1</td> 
  </tr> 
 </tbody> 
</table>

<p></p>  
相关代码：

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

显示效果：

<p></p>

## 显示链接中带括号的图片 ##

!\[\]\[1\]  
\[1\]: [http://latex.codecogs.com/gif.latex][http_latex.codecogs.com_gif.latex]?\\prod%20(n\_\{i\})+1

代码如下:

![][1]
    [1]: http://latex.codecogs.com/gif.latex?\prod%20$n_{i}$+1

## 结语 ##

以上几种格式是比较常用的格式，所以我们针对这些语法做了比较详细的说明。除这些之外，Markdown 还有其他语法，如想了解和学习更多，可以参考这篇[『Markdown 语法说明』][Markdown 2]。

强烈建议您现在就立马用 Markdown 写一篇文章吧，体会一下 Markdown 的优雅之处！

最后，希望我们的指南可以帮助到您，也希望[「简书」][Link 1]能够成为您书写 Markdown 的最佳选择。

[Link 1]: https://www.jianshu.com/
[Markdown]: https://www.jianshu.com/p/qqGjLN
[Markdown 1]: https://www.jianshu.com/p/PpDNMG
[Markdown 2]: https://link.jianshu.com/?t=http://wowubuntu.com/markdown/
[http_www]: https://link.jianshu.com/?t=http://www
[jianshu.com]: https://jianshu.com/
[431]: /images/20220604/7ce9db0168424e8e810dde8ae4d4938e.png
[700]: /images/20220604/a49c04e45d6b47d6a1586c01442ac7a3.png
[700 1]: /images/20220604/c5d2e948c95945518aa35956485ff97a.png
[700 2]: /images/20220604/394624f457824a86baec6c9e0c03d695.png
[700 3]: /images/20220604/080e92498f7a47aa9b4457d5c59dffe2.png
[700 4]: /images/20220604/c2f1f3db21a04d7698384416a9528c55.png
[700 5]: /images/20220604/641aa1db49a84be39f49c754758b7f74.png
[700 6]: /images/20220604/5c9d91d589294f7e97db3faf64de62d1.png
[http_latex.codecogs.com_gif.latex]: https://link.jianshu.com/?t=http://latex.codecogs.com/gif.latex