首页 > 其他分享 >Markdown 常用语法

Markdown 常用语法

时间:2024-07-29 15:41:19浏览次数:17  
标签:常用 Markdown 效果 单元格 第二项 语法 第一项

上一篇简单介绍了 Markdown 是什么,以及如何使用,本篇就来详细说说 Markdown 的常见语法。

注意,并不是所有编辑器,都支持所有的 Markdown 语法,如果遇到失效的也不必疑惑。

此外,不同的编辑器的语法可能有点不同。

标题

语法格式:

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

效果:标题字体一般更大,更醒目,常用于组织文章结构。

强调语法

支持加粗、斜体、下划线等等,还支持互相组合。

加粗

语法:在文本两边各用两个星号

**粗体文本**

效果:粗体文本

斜体

语法:在文本两边各用一个星号或下划线

*斜体文本*
_斜体文本_

效果:斜体文本

分隔线

在一行中用三个以上的星号、减号、底线来建立一个分隔线,行内不能有其他东西。也可以在星号或是减号中间插入空格。

下面每种写法都可以建立分隔线:

***

*****

- - -

----------

效果:





删除线

语法:在文本两边各用两个波浪线

~~要被加上删除线的文字~~

效果:要被加上删除线的文字

下划线

语法:通过 HTML 的 <u>​ 标签来实现

<u>带下划线的文本</u>

效果:带下划线的文本

脚注

脚注是对文本的补充说明,语法:

[^脚注]

然后在文件末尾或其他位置给“脚注”添加内容,语法格式:

[^脚注]: 这是脚注的内容

效果:将鼠标放到“脚注”上时,会出现一个注明框,内容时你定义的内容

注意:有些网站/编辑器不支持该语法

上标/下标

有时候需要输入上标或者下标,例如:

2^2^
H~2~O

效果:

22

H2O

注意:部分编辑器不支持,Typora 的话需要在设置里开启该功能。

粗斜体文本

粗体和斜体的互相组合,语法:

***粗斜体文本***
 ___粗斜体文本___

效果:粗斜体文本

列表

无序列表

使用星号 *​ ,加号 +​ ,或是减号 -​ 作为列表标记:

* 第一项
* 第二项

+ 第一项
+ 第二项

- 第一项
- 第二项 

效果:

  • 第一项

  • 第二项

  • 第一项

  • 第二项

  • 第一项

  • 第二项

建议:在一个列表中始终用同一种写法,不要混用 *​ 、-​ 和 +​。

有序列表

使用数字并加上.​ 号来表示:

1. 第一项
2. 第二项

效果:

  1. 第一项
  2. 第二项

带复选框的列表

语法:* [] 任务​,还可以在方括号内填充 x 表示已完成

* [x] 第一项
* [ ] 第二项
* [ ] 第三项

效果:

注意:部分 Markdown 编辑器不支持

列表嵌套

示例:

1. 第一项:
    - 第一项嵌套的第一个元素
    - 第一项嵌套的第二个元素
2. 第二项:
    - 第二项嵌套的第一个元素
       - 第三层嵌套

效果:

  1. 第一项:

    • 第一项嵌套的第一个元素
    • 第一项嵌套的第二个元素
  2. 第二项:

    • 第二项嵌套的第一个元素

      • 第三层嵌套

引用

例如引用名人名言、书籍里的内容时,可以用这个。语法:

> 人类的悲欢并不相通,我只觉得他们吵闹。

效果:

人类的悲欢并不相通,我只觉得他们吵闹。

引用也是可以嵌套的(在引用里还可以使用列表、加粗等语法):

> 第一层
> > 第二层
> > > 第三层

效果:

第一层

第二层

第三层

> 区块中使用列表
> 1. 第一项
> 2. 第二项
> * 111
> * 222

效果:

区块中使用列表

  1. 第一项

  2. 第二项

    • 111
    • 222

超链接

有时候需要引用其他网站,这时候就可以用超链接。语法:

[链接名称](链接地址)

示例:

[谷歌](http://www.google.com)

效果:谷歌

也可以用尖括号将 URL 或 Email 地址变为可点击的链接,示例:

<https://www.peterjxl.com>

效果:<https://www.peterjxl.com>

这里得额外说下,链接还可以用变量来代替。

什么意思呢?有些情况下,一个超链接会经常出现在文章中,那么文章内容就会显得很冗余:

[谷歌](http://www.google.com)(Google),这个全球知名的科技公司,
以其卓越的技术和丰富的产品线,深刻影响着我们的生活。
以下,我将带您领略[谷歌](http://www.google.com)的魅力,探索其丰富的互联网生态。

[谷歌](http://www.google.com),这个充满创新和智慧的科技公司,
正以其强大的技术实力和丰富的产品线,不断改变着我们的世界。
让我们一起感受[谷歌](http://www.google.com)的魅力,探索更多未知的精彩!


此外,这样还有一个缺点,就是如果网址失效了,还得逐个替换。

为此,我们可以用变量的语法(注意,两个都是方括号):

[Google][1]

然后在文档的结尾(或其他位置),给这个变量 1​ 复制:

 [1]: http://www.google.com/

此时达成的效果,和之前是一样的,但文章内容更精简:

[谷歌][1](Google),这个全球知名的科技公司,
以其卓越的技术和丰富的产品线,深刻影响着我们的生活。
以下,我将带您领略[谷歌][1]的魅力,探索其丰富的互联网生态。

[谷歌][1],这个充满创新和智慧的科技公司,
正以其强大的技术实力和丰富的产品线,不断改变着我们的世界。
让我们一起感受[谷歌][1]的魅力,探索更多未知的精彩!


[1]: http://www.google.com

图片

Markdown 支持引用外部图片,包括本地图片和网络图片,语法:

![图片说明](图片链接)

示例:

![老婆](https://image.peterjxl.com/wife.jpg)
![老婆](C:\Documents\wife.png)

效果:展示一张图片

当图片无法被加载的时候(例如图片失效、或断网了),图片说明会被显示出来,这样做至少还能给读者传递出一点有用信息。

此外,还可以使用 HTML 的 img 标签,优点是可以设置图片宽高:

<img src="https://image.peterjxl.com/wife.jpg" width="50px" height="30px">

如果你的文章只会在本地浏览,那么链接使用本地图片路径没有任何问题,但是如果文章需要发布到网上,或者需要在其它电脑上浏览,那么使用本地图片路径的方式就不可行了,因为其他设备可不一定在这个路径上有图片。

所以,通常情况下建议使用网络链接的方式来插入图片,这种方式可以跨设备,通用性更好。

但是这会带来一个问题:自己的图片该如何上传到网上,并且得到其网络链接地址?这就要用到图床了,详情可以参考我的博客搭建系列-图床篇

PS:图片也可以用超链接的那个变量语法

![老婆][img]

[img]: https://image.peterjxl.com/wife.jpg

代码块

对于程序员来说,经常需要记录代码块,此时就可以用该语法。

单行代码的语法:用反引号把它包起来( `

`alert()`

效果:alert()

如果是多行代码:用三个反引号 ``` 包裹一段代码,并且可以并指定一种语言(指定后有代码高亮)

‍```javascript
function test() {
	alert('test')
}
​‍```

效果:

function test() {
	alert('test')
}

设置目录

自动根据该文件的所有标题来生成一个目录,一般在文章最顶部使用。语法:

[TOC]

效果:自动根据本文的标题生成目录


目录

注意:有些编辑器不支持。

如果你使用 VuePress 搭建博客,请使用 [[toc]]​,不过 VuePress 一般会自动生成目录,不用额外在文章顶部用该语法

表格

基本语法:

|  表头   | 表头  |
|  ----  | ----  |
| 单元格  | 单元格 |
| 单元格  | 单元格 |

使用 |​ 来分隔不同的单元格,使用 -​ 来分隔表头和其他行。

效果:

表头 表头
单元格 单元格
单元格 单元格

还可以设置每一列的对齐方式,在表头下一行里配置即可:

  • -: ​:设置内容和标题栏居右对齐
  • :-​: 设置内容和标题栏居左对齐
  • :-​ : 设置内容和标题栏居中对齐

示例:

| 左对齐 | 右对齐 | 居中对齐 |
| :-----| ----: | :----: |
| 单元格 | 单元格 | 单元格 |
| 单元格 | 单元格 | 单元格 |

效果:

左对齐 右对齐 居中对齐
单元格 单元格 单元格
单元格 单元格 单元格

支持 emoji

在 emoji 表情的英文名前后加上冒号即可,语法:

:smirk:

效果:

标签:常用,Markdown,效果,单元格,第二项,语法,第一项
From: https://www.cnblogs.com/PeterJXL/p/18330216

相关文章

  • 常用Git 管理工具
    图形界面工具GitHubDesktopGitHub开发的一款跨平台的图形化Git工具,支持Windows、macOS和Linux。特点包括简洁的用户界面、易于创建和管理仓库、提交变更、分支管理等。SourceTreeAtlassian提供的一款免费的跨平台Git和Mercurial客户端。支持Windows和......
  • 如何在Markdown中插入公式
    如何优雅地在Markdown中输入数学公式参考:作者:咕噜咕噜酱链接:原文链接版权声明:本作品采用知识共享署名-非商业性使用-禁止演绎2.5中国大陆许可协议进行许可。对于一些理科生来说,在学习数学知识的时候,在计算机上写公式是比较头疼的事情。好在Markdown支持LATEX公式输入,在......
  • Python内置模块常用总结
    目录unittestunittest点击查看代码importunittestfromhtmltestreportimportHTMLTestReportclassTestOne(unittest.TestCase):@classmethoddefsetUpClass(cls)->None:print(f'setUpClass')@classmethoddeftearDownClass......
  • Java8 Stream操作流10条常用方法
    1.filter过滤满足条件的元素2.mapmap方法将每个元素转换成另一个类型,并返回新的流3.flatMap与map类似,可以用来扁平化多层嵌套4.distinct去除流中的重复元素5.sorted对流中的元素进行排序6.limit可以限制流中的元素数量7.skip可以跳过流中的前n个元素8.reduce......
  • 10:Pycharm 常用快捷键大全
    本文对Pycharm常用快捷键进行了汇总整理,如果学习,相信这些快捷键一定能提高Python编程的效率。2.代码补全  当你输入代码时,按下Tab键可以自动补全当前的代码或变量名。如果有多个可能的选项,你可以按下Tab键多次来循环浏览这些选项。3.代码缩进  在Python中,代码块的缩进非......
  • 一键语法错误增强工具 ChineseErrorCorrector
    一键语法错误增强工具欢迎使用一键语法错误增强工具,该工具可以进行14种语法错误的增强,不同行业可以根据自己的数据进行错误替换,来训练自己的语法和拼写模型,可以支持的14种不同语法错误增强,分别为:1.缺字漏字2.错别字错误3.缺少标点4.错用标点5.主语不明6.谓语残缺7.宾语残......
  • [Java]基础语法
    注释注释就是程序中对代码进行解释说明的文字生效范围:注释不影响程序执行,因为运行的字节码文件中不保留注释字面量数据在程序中的书写格式称为字面量变量在内存中开辟一块区域,用来存储数据,这块空间称为变量定义变量使用变量变量的优势便于数据的扩展和......
  • Linux常用命令—权限
    Linux常用命令Linux是一个强大的操作系统,广泛应用于服务器、开发和嵌入式系统中。掌握一些常用的Linux命令对于高效地使用系统非常重要。以下是常用的Linux命令和说明。Linux权限管理 //Linux权限管理操作系统中每个文件都拥有特定的权限、所属用户和所属组。   ......
  • Linux常用命令
    Linux常用命令Linux是一个强大的操作系统,广泛应用于服务器、开发和嵌入式系统中。掌握一些常用的Linux命令对于高效地使用系统非常重要。以下是常用的Linux命令和说明。ps-ef|grep:查询进程//查询进程 //ps-ef|greppid //ps-ef|grep端口号 //ps-ef|grep......
  • 最细哈希表相关的力扣题和讲解和Java、C++常用的数据结构(哈希法)来源于代码随想录,十分
    20240725一、什么时候适用什么样的结构。1.java中1.1HashSet:1.2TreeSet:1.3LinkedHashSet:1.4HashMap:1.5TreeMap:1.6LinkedHashMap:1.7总结2.c++中2.1std::unordered_set:2.2std::set:2.3std::multiset:2.4std::unordered_map:2.5std::map:2.6std::multimap:3代码......