Markdown基本语法笔记

摘自Markdown官方教程

基本语法

Markdown是一种轻量级标记语言,排版语法简洁,让人们更多地关注内容本身而非排版。它使用易读易写的纯文本格式编写文档,可与HTML混编,可导出 HTML、PDF 以及本身的 .md 格式的文件。因简洁、高效、易读、易写,Markdown被大量使用,如Github、Wikipedia、简书等。

在线体验在线markdown编辑器

Markdown的语法十分简单,常用的标记符号不超过十个,用于日常写作记录绰绰有余,不到半小时就能完全掌握,而就是这十个不到的标记符号,却能让人优雅地沉浸式记录,专注内容而不是纠结排版,达到「心中无尘,码字入神」的境界。

标题语法

要创建标题,在单词或短语前面添加井号(#)。#号的数量代表了标题的级别。为了兼容考虑,用一个空格在#和标题之间进行分隔

段落语法

创建段落,使用空白行将一行或多行文本进行分隔

换行语法

在一行的末尾添加两个或者多个空格,然后按回车键,即可创建一个换行。或者添加HTML标签“<br>”也可换行。(换行在宇宙第一编辑器vscode中,单击enter键会自动识别为换行,但是在mac版vscode中则需要添加空格后换行)

强调语法

markdown的强调语法仅包含斜体和粗体。

粗体(Bold)使用两个星号(**)或两个下划线(__)将文本包含起来即可。如**这是粗体文本**或者__这是粗体文本__会被渲染为这是粗体文本
斜体(Italic)使用一个星号(*)或一个下划线(_)将文本包含起来即可。如*这是斜体文本*或者_这是斜体文本_会被渲染为这是斜体文本

引用语法

单个段落引用

创建引用,在段落之前添加一个>符号即可。如">这是一段引用"会被渲染为

这个是一段引用

多个段落引用

多个段落的引用需要在段落之间的空白行添加>符号。

>第一个段落的引用
>
>第二个段落的引用

会被渲染为:

第一个段落的引用

第二个段落的引用

引用的嵌套

引用可进行嵌套,在要嵌套的段落前添加一个>>符号。

>第一级引用
>
>>第二级引用
>
>>>第三级引用

会被渲染为:

第一级引用

第二级引用

第三级引用

引用中可包含其他元素

在引用中可以包含其他markdown格式的元素。but并非所有元素都可以使用,需要实践。

> #### 这是一个四级标题
> - 无序列表
> 1. 有序列表
> *斜体* **粗体**
> ...

会被渲染为:

这是一个四级标题
  • 无序列表
  1. 有序列表
    斜体 粗体

列表语法

有序列表

在每个列表项前添加数字(该数字不需要安装序号顺序)并紧跟一个英文句号和一个空格。

1.第一个列表项
1.第一个列表项
1.第一个列表项
或者
1.第一个列表项
2.第一个列表项
3.第一个列表项
或者
1.第一个列表项
3.第一个列表项
88.第一个列表项

都会被渲染为:

  1. 第一个列表项
  2. 第一个列表项
  3. 第一个列表项

列表的嵌套:

1. 第一个列表项
   1. 第一个列表项子项1
   2. 第一个列表项子项2
2. 第二个列表项
  1. 第一个列表项
    1. 第一个列表项子项1
    2. 第一个列表项子项2
  2. 第二个列表项

无序列表

在每个列表项前面添加一个破折号(-)、星号(*)或者加号(+)。缩进一个或多个列表项可创建嵌套列表。

- 无序列表
- 无序列表
* 无序列表
* 无序列表
+ 无序列表
+ 无序列表

均被渲染为

  • 无序列表
  • 无序列表
- 无序列表
  - 无序列表子项 
  - 无序列表子项
    - 无序列表子项的子项
      - 最多四级啦
- 无序列表
  • 无序列表
    • 无序列表子项
    • 无序列表子项
      • 无序列表子项的子项
        • 最多四级啦
  • 无序列表

代码语法

单词或短语将其包含在(`)中,代码块则包含在(```)中,并写上代码的类型,如(```html)。

<!DOCTYPE html>
<html>
  <head>
    <meta charset=“UTF-8”>
    <title>这是一个HTML5的网页
  </head>
  <body>
    <p>Hello HTML5</p>
  </body>
</html>

渲染为:

<!DOCTYPE html>
<html>
    <head>
        <meta charset="UTF-8">
        <title>这是一个HTML5的网页</title>
    </head>
    <body>
        <p>Hello HTML5</p>
    </body>
</html>

分割线语法

跟word创建分割线类似,使用三个或多个(***)、破折号(---)或下划线(___),不能包含其他内容。

***
---
___
******

链接语法

链接的文本放在中括号([])中,链接地址放在紧挨在中括号后的括号中,链接的title可选。[超链接显示的文本](超链接地址 "超链接的title属性")
超链接显示的文本,鼠标移到此处显示超链接的title,点击跳转到超链接地址

图片语法

添加图片格式:![图片alt文本](图片链接 "图片的title属性")

![这是一张在线的图片,图片无法加载时会显示该文本](https://img-blog.csdnimg.cn/4078d8d2161d4dc6aaab8fe2e5843a75.png?x-oss-process=image/watermark,type_d3F5LXplbmhlaQ,shadow_50,text_Q1NETiBA5LiA5Y-q5pyI5pyI6bif5ZGA,size_20,color_FFFFFF,t_70,g_se,x_16 "图片的title属性,鼠标移入显示")
![这是一张在线的图片,图片无法加载时会显示该文本](httpGA,size_20,color_FFFFFF,t_70,g_se,x_6 "图片的title属性,鼠标移入显示")

这是一张在线的图片,图片无法加载时会显示该文本
这是一张在线的图片,图片无法加载时会显示该文本

转义字符语法

在我们正文中需要使用到markdown的关键字时,可在前面加一个\符号,即可转义该字符。在使用到markdown关键字的时机加上\符号即可,如"`“就需要写为”\`"

  • 1
    点赞
  • 2
    收藏
    觉得还不错? 一键收藏
  • 打赏
    打赏
  • 0
    评论

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

一只月月鸟呀

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付:¥1
获取中
扫码支付

您的余额不足,请更换扫码支付或充值

打赏作者

实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值