MarkDown 基本语法

一、MarkDown是什么好东西?

1.认识MarkDown

MarkDown 是一个 Web 上使用的文本到HTML的转换工具,可以通过简单、易读易写的文本格式生成结构化的HTML文档,MarkDown中文教程(教程-MarkDown)上的介绍,读完有点懵。简单理解,MarkDown格式很简单,然后以MarkDown格式书写的文章可以直接以纯文本发布到支持Markdown编辑模式的平台上,省去排版的困扰。

2.MarkDown优点

  • 简单直观易学
  • 纯文本内容,专心考虑内容,无需困扰排版
  • 可以运用在几乎任何有文字的地方

二、有哪些MarkDown的基本语法?

1.标题

MarkDown通过在行首添加1-6个 # 符号+空格来定义1-6级标题(有的网站不加空格也能识别,但是最好加)。

  • 书写格式
    # 一级标题
    ## 二级标题
    ### 三级标题
    #### 四级标题
    ##### 五级标题
    ###### 六级标题
    眼花缭乱的#,数数数到眼睛疼

  • 解析效果

一级标题

二级标题

三级标题

四级标题

五级标题
六级标题

在简书上写这篇博客的时候发现一个很有趣的东西,哈哈,上图
本来想加无序列表的,结果刚打- 上去就把前面的文字变成标题了

在- 后加了文字就正常了

查了一下,是因为可以使用=(高阶标题) 和- (次阶标题)来标记一级和二级标题,任何数量的= 和- 都有效果

  • 书写格式

一级标题
=
二级标题
-

  • 解析效果

一级标题

二级标题


2. 段落

直接写内容就显示为段落,就是这么简单粗暴。

  • 书写格式
    这是一个段落
  • 解析效果
    这是一个段落

看起来没有毛线区别

3.插入图片

语法:! [ 图片下方显示的东西,可以随便写什么也可以不写 ] ( 图片的线上地址,可以加标题也可以不加 )。本地图片可以使用图床,具体方法可自行查阅。![]()

  • 书写格式


  • 解析效果


注:和HTML相同,插入的图片也可以有一个鼠标悬浮在图片上放就显示设置的标题的效果,简单的在图片地址后面加"Title",Title就是鼠标悬浮显示的标题。

4.插入链接

语法:[ 链接显示文字 ]( 链接地址 "Title" ),Title即鼠标悬浮到此处显示的标题,可加可不加。

5.文字效果

加粗

两种方式:两个(*)或者底线(_)作为标记强调字词的符号,将需要加粗的文字包围即可。

斜体

两种方式:一个(*)或者底线(_)作为标记强调字词的符号,将需要倾斜的文字包围即可。

加粗+斜体

两种方式:三个(*)或者底线(_)作为标记强调字词的符号,将需要加粗+倾斜的文字包围即可。

删除线

两个波浪线~~作为标记强调字词的符号,将需要加删除线的文字包围即可。

  • 书写格式
    这是一段普通的文字
    **这是一段要加粗的文字**
    __这是另外一段要加粗的文字__
    *这是一段要倾斜的文字*
    _这是另外一段要倾斜的文字_
    ***这是一段要加粗和倾斜的文字***
    ___这是另外一段要加粗和倾斜的文字___
    ~~这是一段要加删除线的文字~~
    * 这是一段要倾斜但是 ** 前后都有空白没有倾斜的文字 *

  • 解析效果

这是一段普通的文字
这是一段要加粗的文字
这是另外一段要加粗的文字
这是一段要倾斜的文字
这是另外一段要倾斜的文字
这是一段要加粗和倾斜的文字
这是另外一段要加粗和倾斜的文字
这是一段要加删除线的文字

注:如果*或_或~两边都有空格的话,他们会被当作普通符号。

6.列表

无序列表

- + *加空格,后跟内容。

有序列表

数字加.,序号与内容间要有空格。

  • 书写格式
    - 我是一个无序列表
    + 我也是
    * 好巧,我也是
    1.我是第一个有序列表
    2.我是第二个有序列表
    3.我是第三个有序列表

  • 解析效果

  • 我是一个无序列表

  • 我也是
  • 好巧,我也是
    1.我是第一个有序列表
    2.我是第二个有序列表
    3.我是第三个有序列表

列表嵌套

上级和下级间敲三个空格即可。

  • 书写格式
    - 我是一个无序列表
    + 好巧,我也是
    * 神奇,我也是哦
    1.我是第一个有序列表
    - 我是二级无序列表
    2.我是第二个有序列表
    3.我是第三个有序列表
  • 解析效果
  • 我是一个无序列表
  • 好巧,我也是
  • 神奇,我也是哦
    1.我是第一个有序列表
  • 我是二级无序列表
    2.我是第二个有序列表
    3.我是第三个有序列表
注:这里只演示了有序列表嵌套一个无序列表的写法,其他的嵌套组合也是有效的,可自行测试。

7.表格

  • 书写格式(表头与前面内容隔一行)
    |表头|表头|表头|
    |:-|:--:|---:|
    |内容|内容|内容|
  • 解析效果
表头 表头 表头
内容 内容 内容
注:第二行元素分隔表头和内容,其中 - 一个以上即可, : 在左即内容左对齐,在右即内容右对齐,两边都有即居中对齐。

8.引用

  • 书写格式
    >这是第一个引用
    >>这个第二个引用
    >>>这是第三个引用
  • 解析效果

这是第一个引用

这个第二个引用

这是第三个引用

9. 代码

单行代码

语法:代码左右分别一个 `(反引号,键盘上波浪线下面的符号)包裹代码即可。

  • 书写方式

`var a = 1`

  • 解析效果

var a = 1

代码块

语法:代码左右两边分别用三个```包裹代码块即可。

  • 书写格式

```
var a = 1
var b = 2
```

  • 解析效果。
    var a = 1
    var b = 2

代码高亮

在写需要展示的代码时,标明代码的种类,有的浏览器会自动的给代码加一些颜色

  • 书写格式
    ```JavaScript
    var a = 1
    var b = 2
    ```

  • 解析效果

    var a = 1
    var b = 2

10.分割线

语法:三个或以上 * 或 - 或 _ 可有分割线效果 。

  • 书写方式
    ***
    ---
    ___
  • 解析效果



注:使用 --- 作为水平分割线时,要在它的前面空一行,防止 --- 被当成标题标记的表示方式。

11.角标

语法:这里的角标内容会被放在文末,点击角标可以实现跳转,点击文末的返回按钮即可返回角标,使用 [^] 来定义脚注。

  • 书写格式
    这篇博客是有关MarkDown基本语法的博客[^1] ,希望以后继续加油,多写博客[^2]。
    [^1]:[球丁丁的第一篇学习博客]
    [^2]: [加油加油加油]

  • 解析效果
    这篇博客是有关MarkDown基本语法的博客[1] ,希望以后继续加油,多写博客[2]

  • 文末截图


    文末显示的内容

12. 其他

反斜杠

有时候我们需要在文章中引用一些符号,为了避免这些符号被当作MarkDown标识符发生不必要的格式转化,可以在符号前加 反斜杠\ 来避免。

  • 书写格式
    \# 我不是一级标题
    \- 我不是无序列表
  • 解析效果

# 我不是一级标题
- 我不是无序列表
MarkDown 支持以下这些符号前面加上 反斜杠 来帮助插入普通的符号(表格来源)

符号 含义
\ 反斜杠
` 反引号
* 星号
_ 底线
{} 大括号
[] 方括号
() 括号
# 警号
+ - 加减号
. 英文句号
! 惊叹号

最后推荐一个小游戏可以练习MarkDown基本语法http://commonmark.cn/help/tutorial/

参考资料

  1. [球丁丁的第一篇学习博客]

  2. [加油加油加油]

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

推荐阅读更多精彩内容

  • 欢迎关注微信公众号:北岛向南(id:nanzhouie) GitHub Pages:https://zhouie....
    zhouie阅读 4,812评论 4 72
  • 文字的发明和使用使得信息的保存和传递有了革命性的飞跃。随着信息的丰富和传递方式的革新,人们对文本提出了新的格式化的...
    haoeric阅读 7,500评论 1 16
  • 转载自:https://www.cnblogs.com/crazyant007/p/4220066.html、 目...
    飞向深空阅读 472评论 0 0
  • (小白入手必读) 喜欢简书的朋友,每天看着别人写的文章,自己也总会有想去写一些东西的冲动,可是面对简书的文本编辑格...
    君不器12323阅读 3,325评论 2 27
  • 劝君莫惜金缕衣,劝君惜取少年时。花开堪折直须折,莫待无花空折枝。——杜秋娘·金缕衣 这是一部比预期要沉重的影片,新...
    潘慧敏阅读 937评论 0 7