写简书文章必备的markdown语法(超详细)

持续更新中……

前言:

本来内容来自markdown官方文档

先说明一下:
目前简书有个非常淡腾的一个地方,就是不能写单篇文章的目录用于跳转,但是使用tampermonkey插件编写的脚本只能自己看,并适用于作者,读者又基本不装。所以想要做目录,后面的都不用看了,没用,都要把自己折腾死了。

一、标题与段落

(一)标题

控制标题的样式符号为:#
一个#号表示一级标题,两个#号表示二级标题,以此类推

#一级标题
##二级标题
###三级标题
说明:井号后面可以不加空格,只有这个可以不加空格

效果如下:

一级标题

二级标题

三级标题


(二)段落及相关

标识符 含义 图样
---
***
产生一条水平线,颜色比较暗淡
<br/> 换行,换一行继续输出,可以用在列表中
若放在空行中,则会产生一个空行
左侧就是一个换行样式实例
**需要加粗的文本**
--需要加粗的文本--
加粗被环绕的文本 需要加粗的文本
~~需要加删除线的文本~~ 文本删除线 需要加删除线的文本
*斜体内容* 文本变成斜体字 斜体
> 块引用符 暂时没感觉有什么用,只是出现一个灰色框包裹文本
&nbsp; 一个空格

二、表格与列表

1.无序列表

”+“,”-“,”*“符号开头都能表示一个无序列表,标识符后面一定要有一个空格

- 无序第一行
- 无序第二行
+ 无序第一行
+ 无序第二行
* 无序第一行
* 无序第二行

注意:
前面用“-”标明无序列表,后面面用“+”标明无序列表,两个不同标识符之间会产生一个空行
效果如下:

  • 无序第一行
  • 无序第二行
  • 无序第一行
  • 无序第二行
  • 无序第一行
  • 无序第二行

2.有序列表

3. 第一列
1. 第一列
2. 第一列
1. 第一列
说明:修改的序列号为2,但是还是不会变

说明:
可以以任何(第一行的)数字开头,会自动以第一个为起始,后续自动编号命名,需要空格之后接列表内容;可以在数字后加“.”,但其他字符不行

  1. 第一列
  2. 第一列
  3. 第一列
  4. 第一列

注意:在同一个标题(不包括下级与上级标题)内的有序序列只能有一个,就算有文本和换行符标志之后也是一样,它会自动进行更改序列号。

3.列表嵌套

3.1有序列表嵌套

注意:缩进的是两个Tab键

1. First item
2. Second item
3. Third item
    1. Indented item
    2. Indented item
4. Fourth item

  1. First item
  2. Second item
  3. Third item
    1. Indented item
    2. Indented item
  4. Fourth item

3.2有序与无序列表相互嵌套

1. First item
2. Second item
3. Third item
    - Indented item
    - Indented item
4. Fourth item

结果:

  1. First item
  2. Second item
  3. Third item
    • Indented item
    • Indented item
  4. Fourth item

4.表格

  1. First item
  2. Second item
  3. Third item
    1. Indented item
    2. Indented item
  4. Fourth item
| 列名1 |列名2| 列名3|
| :-: |:-:|:-:|
|第一列|第二列|第三列|

效果如下:

列名1 列名2 列名3
第一列 第二列 第三列

说明:

  • 开头是列名,以“|”为起始,并使用其作为分隔符;同时根据列名长度自动分配列表单元格长度
  • | :-: |:-:|:-:|和列名一样作为必要的书写,表明这是一个列表,并按照如下格式书写;
  • “:”放在“-”左边,表明左对齐,放在右边表明右对齐,放两边,表明居中对齐。

注意:
在使用表格时,表格列与列之间不能又能有换行,否则列表会断掉

| 列名1 |列名2| 列名3|
| :-: |:-:|:-:|
|第一列|第二列|第三列|

|第一列|第二列|第三列|

效果如下:

列名1 列名2 列名3
第一列 第二列 第三列

|第一列|第二列|第三列|

三、代码块及相关内容

(一)代码行

    三个tab键可以达到和首尾各三个反引号相同的目的:单行代码。
注意:在后面回车是没有用的,回车后的内容不会显示

(二)将单词或短语表示为代码

将要转为代码的单词或者短语括在反引号(`)中

  At the command prompt, type `nano`.

效果如下:
At the command prompt, type nano.

(三)代码块

三个反引号做一行开头,再三个反引号做一行结尾,中间写代码

    ```(这里可以写java,python等编码语言,里面的内容会自动根据语言进行标识)
    代码内容
    ```

效果:

      ```json
      {
        "firstName": "John",
        "lastName": "Smith",
        "age": 25
      }
      ```
{
  "firstName": "John",
  "lastName": "Smith",
  "age": 25
}

四、链接与图片

五、转义字符

若需要显示特殊字符,需要在特殊字符前面加反斜杠“\”,特别是特殊字符紧紧挨着时

需要转义的特殊字符 含义
\ 反斜杠
` 反引号
* 星号
_ 下划线
{} 大括号
[] 括号
<> 尖括号
() 括弧
英镑符号
+ 加号
-- 减号(连字符)
感叹号
| 管道
©著作权归作者所有,转载或内容合作请联系作者
平台声明:文章内容(如有图片或视频亦包括在内)由作者上传并发布,文章内容仅代表作者本人观点,简书系信息发布平台,仅提供信息存储服务。

推荐阅读更多精彩内容

  • 如有纰漏,敬请指出!谢谢~ Markdown的宗旨 目标是实现「易读易写」。一份使用 Markdown 格式撰写的...
    goyohol阅读 4,452评论 4 21
  • Markdown语法 标题 在文本之前添加一到六个#符号就可以创建一个标题。您使用的#号将决定标题的大小。 这是1...
    rwli阅读 315评论 0 0
  • Markdown是一种轻量级的「标记语言」 Markdown是一种可以使用普通文本编辑器编写的标记语言,通过简单的...
    JSC_erry阅读 1,095评论 0 1
  • 标题 一级标题: #二级标题: ##三级标题: ###四级标题: ####五级标题: #####六级标题: ###...
    忠胜阅读 641评论 0 4
  • 如需在线托管MarkDown文档,建议选择文档仓库,这是一个永久免费的中文文档在线管理工具,支持Markdown和...
    开心的锣鼓阅读 695评论 0 1