简书markdown基本语法(每水)2019-08-02

一、基本元素

  • 标题
  • 列表:有序列表、无序列表,嵌套列表
  • 引用
    • 引用文本
    • 嵌套引用文本
    • 行内代码
    • 多行代码
  • 字体和效果
    • 强调:粗体、斜体
    • 修饰线:下划线、删除线、高亮
    • 上标、下标
  • 分割线
  • 表格
  • 链接和图片
    • 超链接、图片
    • 行内式、参考式
    • 自动链接
  • 转义
  • 公式:行间公式、行内公式

二、基本语法要点

注:1. markdown语法符号大部分为前缀式,字体和效果、代码、公式为括号式,个别为底线式;2. 前缀式后要紧跟一个空格;3. 底线形式的标题和参考式链接的地址部分必须在独立分块中(最简单的方法是在前面添加一个空行);

  • 标题:
    • #号形式:1级到6级,1到6个#;
    • 底线形式:=-分别表示一级和二级标题
  • 列表:
    • 有序列表:1. 2. 3. ...
    • 无序列表:-、+、*
    • 嵌套列表:比上一级多两个以上空格则为嵌套列表
  • 引用
    • 引用文本:>
    • 嵌套引用文本:>>
    • 行内代码:`
    • 多行代码:```
  • 字体和效果
    • 粗体和斜体:**、__、*、_
    • 下划线、删除线、高亮:++、~~、==
    • 上标、下标:^、~
  • 分割线:***---___
  • 表格:|:
  • 链接和图片
    • 超链接、图片:[]()![]()
    • 行内式、参考式:[][]![][]
    • 自动链接:<>
  • 转义:\
  • 公式:
    • 行间公式:$$
    • 行内公式:$

三、示例

标题

  • #号形式(推荐)
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题

效果:

一级标题

二级标题

三级标题

四级标题

五级标题
六级标题
  • 底线形式:=和-分别表示一级和二级标题
一级标题
============
二级标题
---------------------

效果:

一级标题

二级标题

注:1. 标题文字上一行不能在同一段内(即前一个元素必须是分块元素,不能是普通文字和行内元素!),最简单实现方法就是前面加一个空行!2. = 和 - 的个数不限;

列表

  • 有序列表(1. 2. 3. ...)

代码:

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

效果:

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

注:我的代码中第3个序号没写错,确实写的是2,因为即使代码中的序号不对也没关系,但序号最好以1开始,因为markdown以后有可能支持指定起始序号。

  • 无序列表(+、-、*)
+ 列表项1
+ 列表项2
+ 列表项3

- 列表项1
- 列表项2
- 列表项3

* 列表项1
* 列表项2
* 列表项3

效果:

  • 列表项1
  • 列表项2
  • 列表项3
  • 列表项1
  • 列表项2
  • 列表项3
  • 列表项1
  • 列表项2
  • 列表项3
  • 嵌套列表(比上一级多两个以上空格则为嵌套列表)

代码:

+ 一级列表项1
  - 二级列表项1
  - 二级列表项2
  - 二级列表项3
+ 一级列表项2
  * 二级列表项1
  * 二级列表项2
  * 二级列表项3
+ 一级列表项3
  + 二级列表项1
    + 三级列表项1
    + 三级列表项2

效果:

  • 一级列表项1
    • 二级列表项1
    • 二级列表项2
    • 二级列表项3
  • 一级列表项2
    • 二级列表项1
    • 二级列表项2
    • 二级列表项3
  • 一级列表项3
    • 二级列表项1
      • 三级列表项1
      • 三级列表项2

注:嵌套列表时,可以使用相同的字符,也可以使用不同的字符。

引用

  • 引用文本:

代码:

> 引用的内容

效果

引用的内容

  • 嵌套引用文本:
> 引用的内容
>> 嵌套引用内容

效果

引用的内容

嵌套引用内容

  • 行内代码:
这是`行内代码`效果

效果

这是行内代码效果

  • 多行代码:
    ```text
    这是多行代码效果
    这是多行代码效果
    这是多行代码效果
    ```
  • 多行代码:
```text
这是多行代码效果
这是多行代码效果
这是多行代码效果
```

效果:

这是多行代码效果
这是多行代码效果
这是多行代码效果

注:1. 在代码中使用反引号时,只需要使用较多的连续反引号作为起止标记即可!2. 文本(“>”)引用中可以使用其他大多数markdown字符;而代码引用中则不行;3. 文本可以多层嵌套,只需使用多个“>”即可;

字体和效果

  • 强调(*、**、_、__,通常一个符号时为斜体,两个符号时为粗体)
斜体:*强调1*,_强调3_
粗体:**强调2**,__强调4__

效果:

斜体:斜体1斜体2
粗体:粗体1粗体2

  • 下划线、删除线、高亮
下划线:++下划线++
删除线:~~删除线~~
高亮:==高亮==

效果:(简书不支持下划线和高亮)

下划线:++下划线++
删除线:删除线
高亮:==高亮==

  • 上标和下标
上标:A^2^
下标:A~2~

效果:

上标:A2
下标:A2

分割线:***---___

  • 分页
***

效果:


  • 分节
---

效果:


  • 换行
___

效果:


注:1. 中间可以使用空格间隔开;2. 在简书中这几种分割线效果都是一样的;

表格

注:1. 在第2行中可使用“:”设置某列的左、中、右对齐;2. 用“|”来分割列,第1行和第2行中“|”的个数必须相等,最左和最右的“|”可省略;3. 第2行中的“-”的数量不限;
代码:

默认对齐|中间对齐|右对齐
----|:----:|----:
a        |b       |c
e        |f         |g
h|i|j

效果:

默认对齐 中间对齐 右对齐
a b c
e f g
h i j

超链接和图片

  • 超链接
超链接格式:[链接文字](链接地址 "链接的title属性值")
示例:
欢迎访问[每水的简书](https://www.jianshu.com/u/2db0e7ca08a4 "一个IT男")
我的文章:[简书markdown基本语法](https://www.jianshu.com/p/717aeeb843cc "本文链接")

效果:

欢迎访问每水的简书
我的文章:简书markdown基本语法

注:简书在预览模式下支持title,而在发布时不支持!

  • 图片
图片格式:![alt,在简书中同时也是图片说明](图片地址 "title")
示例:
![海天一色](https://upload-images.jianshu.io/upload_images/19039432-46357069f5085a72.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240 "plane_over_sea.png")

效果:

海天一色

注:alt和title可以不写;

  • 行内式和参考式
    上面插入超链接和图片的方式即为行内式,地址和显示内容写在一起;
    参考式则将地址与显示内容分开来写,通常地址集中写在一起;多个显示内容可使用同一个地址;
    代码:
我经常去的几个网站[GitHub][1]、[知乎][2]以及[简书][3],[简书][3]是一个不错的[写作社区][],这篇文章首发于[简书][3]。

[1]:https://github.com "GitHub"
[2]:https://www.zhihu.com "知乎"
[3]:http://www.jianshu.com "简书"
[写作社区]:http://www.jianshu.com

效果:

我经常去的几个网站GitHub知乎以及简书简书是一个不错的写作社区,这篇文章首发于简书

图片也可以使用参考式

这是网上找到的一张图片![海][p1],我非常喜欢这张图片![天][p1],如果图片![一色][p1]侵权,请告知侵删;

[p1]:https://upload-images.jianshu.io/upload_images/19039432-46357069f5085a72.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240 "plane_over_sea.png"

效果:

这是网上找到的一张图片

,我非常喜欢这张图片
,如果图片
一色
侵权,请告知侵删;

注:1. 参考式的链接地址部分要位于独立块;

  • 自动链接:用尖括号<>将链接括起来,链接地址与尖括号中的内容一样。

代码:

我的简书:<https://www.jianshu.com/u/2db0e7ca08a4>

效果:

我的简书:https://www.jianshu.com/u/2db0e7ca08a4

转义

方法:在需要转义的字符前加反斜线\
需要转义的字符

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

注:代码中的字符不需要转义;

公式

  1. 行间公式:
格式:$$数学公式$$
示例:
$$e^{i*\pi}+1=0$$

效果:

e^{i\pi}+1=0

  1. 行内公式:
格式:$数学公式$
示例:
三角函数公式$\cos (2\theta) = \cos^2 \theta - \sin^2 \theta$是一个常用的公式;

效果:

三角函数公式\cos (2\theta) = \cos^2 \theta - \sin^2 \theta是一个常用的公式;

数学公式的详细用法见:https://en.wikibooks.org/wiki/LaTeX/Mathematics

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 204,053评论 6 478
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 85,527评论 2 381
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 150,779评论 0 337
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,685评论 1 276
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,699评论 5 366
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,609评论 1 281
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 37,989评论 3 396
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,654评论 0 258
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,890评论 1 298
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,634评论 2 321
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,716评论 1 330
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,394评论 4 319
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 38,976评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,950评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,191评论 1 260
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 44,849评论 2 349
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,458评论 2 342

推荐阅读更多精彩内容