markdown语法小记——旨在一眼学会markdown

其实日常使用markdown也就会个标题，段落换行，强调，图片，链接，代码块就够了
但是写都写了，我打算在语法上写的全面一些
每个部分的前面都是最基础最日常的使用情况

下面是正文

标题

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

#后必须要有空格

还可以在文本下方添加任意数量的 == 号来标识一级标题，或者 -- 号来标识二级标题。
Heading level 1
===============
Heading level 2
---------------

在实际渲染中，'#' 号数量对应标题级别，一个 '#' 是一级标题，两个 '#' 是二级标题，以此类推。
#的叠加可以很多，但是当过多之后，会变的比正常字体还要小，可以利用这个特性

段落，换行，缩进

换行

句子末尾双空格代表换行。或者多个空格进行换行
<br> 貌似也可以

段落

处理段落就是用空白行将一行或多行文本进行分割
注意：不要用空格（spaces）或制表符（ tabs）缩进段落。

缩进

格式：

&ensp;：输入一个空格
&nbsp;：输入一个空格
&emsp;：输入两个空格

强调

*斜体文本*   前后各添加一个星号或下划线  
_斜体文本_
**粗体文本**   前后各添加两个星号或下划线  
__粗体文本__
***加粗斜体文本***
~~删除线文本~~

粗体和斜体可以混合用

代码块

行内代码：用反引号 包裹代码片段，如System.out.println("Hello World");
代码块：使用三个反引号 包裹代码块，并可在其后指定语言（可选，用于语法高亮）

​```代码语言
内部代码
注意```需要闭合

貌似三个波浪号也可以~~~ ~~~

### 链接
- **行内式链接**：`[链接文本](链接地址 "可选标题")`，例如：[百度](https://www.baidu.com "百度首页")
- **参考式链接**：
[链接文本][链接标识]
[链接标识]: 链接地址 "可选标题"

引用

> 这是一段引用文本
> 引用可以有多行
> 若有多段引用，可在每段前加 > 符号。
> 嵌套块引用

块引用可以嵌套。在要嵌套的段落前添加一个 >> 符号。
块引用可以包含其他 Markdown 格式的元素。但并非所有元素都可以使用
我已经验证了强调和段落换行表格可以用
​```markdown

这是一段引用文本
引用可以嵌套

我继续引用

我还引用

> 这是一段引用文本
> 引用可以嵌套
> > 我继续引用
> >
> > > 我还引用  
> > >
> > > ***
## 分割
以上三种写法都可生成一条分隔线。  
***
## 列表
### 有序列表
要创建有序列表，请在每个列表项前添加数字并紧跟一个英文句点。  
数字不必按数学顺序排列，但是列表应当以数字 1 起始。  
​```markdown
1. 列表项1
2. 列表项2
   1. 子列表项1
   2. 子列表项2
3. 列表项3

无序列表

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

- 列表项1
  - 子列表项1
  - 子列表项2
+ 列表项2
* 列表项3

列表中来回嵌套的问题

在如果需要列表中嵌套其他元素，基本所有都可以，甚至图片，拿代码块举例子
要在保留列表连续性的同时在列表中添加另一种元素，请将该元素缩进四个空格或一个制表符

1.  列表行1
2.  下面是代码
 
        &<html>
          &lt;head>
            &lt;title>Test&lt;/title>
          &lt;/head>
 
3.  同样的，列表也可以嵌套列表

  1. 列表行1

  2. 下面是代码

    		<html>
    		  <head>
    		    <title>Test&lt;/title>
    		  </head>

  3. 同样的，列表也可以嵌套列表

表格

基本表格语法

表头与内容分隔：使用 | 来分隔表格的列，表头与表格内容之间通过 --- 分隔，--- 还可用于指定列的对齐方式。

| 表头1 | 表头2 | 表头3 |
| :---: | :-- | --: |
| 居中内容 | 左对齐内容 | 右对齐内容 |
| 第二行数据1 | 第二行数据2 | 第二行数据3 |
表头1 表头2 表头3
居中内容 左对齐内容 右对齐内容
第二行数据1 第二行数据2 第二行数据3

表格内容换行

如果表格内容需要换行，可以直接在 Markdown 源文件中使用 HTML 的
标签。
支持扩展语法的编辑器中，也可以通过在单元格内容中按回车键进行换行，然后适当缩进以保持格式。

| 列1 | 列2 |
| ---- | ---- |
| 长内容 <br> 换行显示 | 其他内容 |
列1 列2
长内容
换行显示		 其他内容

合并单元格

标准 Markdown 语法本身不支持直接合并单元格。
不过，在一些特定的 Markdown 渲染器（如在 Markdown 中嵌入 HTML 时），可以使用 HTML 的

标签来实现。

图片

行内式图片：替代文本
例如：示例图片，换成你自己的图片链接
参考式图片：

![替代文本][图片标识]
[图片标识]: 图片地址 "可选标题"

任务列表

任务列表可以创建带有复选框的项目列表。在支持任务列表的Markdown应用程序中，复选框将显示在内容旁边。
在任务列表项之前添加破折号-和方括号[ ]，并在[ ]前面加上空格。
要选择一个复选框，请在方括号[x]之间添加 x 。

- [x] Write the press release
- [ ] Update the website
- [ ] Contact the media

转义字符

在字符前面添加反斜杠字符 \ ，这样markdown会识别不去执行该符号
例如
* Without the backslash, this would be a bullet in an unordered list.

  • Without the backslash, this would be a bullet in an unordered list. 不加就会被识别成列表

内嵌html代码

对于 Markdown 涵盖范围之外的标签，都可以直接在文件里面用 HTML 本身。
如需使用 HTML，不需要额外标注这是 HTML 或是 Markdown，只需 HTML 标签添加到Markdown 文本中即可
html里面咋用，在这里就可以咋用

插入表情符号

可以简单地从Emojipedia 等来源复制表情符号并将其粘贴到文档中。
许多Markdown应用程序会自动以Markdown格式的文本显示表情符号。从Markdown应用程序导出的HTML和PDF文件应显示表情符号。

编写本篇博客的markdown代码

Markdown语法参考 ## 标题 ```markdown # 一级标题 ## 二级标题 ### 三级标题 #### 四级标题 ##### 五级标题 ###### 六级标题 ``` **#后必须要有空格** ```markdown 还可以在文本下方添加任意数量的 == 号来标识一级标题，或者 -- 号来标识二级标题。 Heading level 1 =============== Heading level 2 --------------- ``` 在实际渲染中，'#' 号数量对应标题级别，一个 '#' 是一级标题，两个 '#' 是二级标题，以此类推。 #的叠加可以很多，但是当过多之后，会变的比正常字体还要小，可以利用这个特性 *** ## 段落和换行 #### 换行 **句子末尾**双空格代表换行。或者多个空格进行换行
貌似也可以 #### 段落 处理段落就是用空白行将一行或多行文本进行分割 注意：不要用空格（spaces）或制表符（ tabs）缩进段落。 *** ## 强调 ```markdown *斜体文本* 前后各添加一个星号或下划线 _斜体文本_ **粗体文本** 前后各添加两个星号或下划线 __粗体文本__ ***加粗斜体文本*** ~~删除线文本~~ ``` 粗体和斜体可以混合用 *** ## 代码块 行内代码：用反引号 包裹代码片段，如System.out.println("Hello World"); 代码块：使用三个反引号 ``` 包裹代码块，并可在其后指定语言（可选，用于语法高亮）``` ``` ​```代码语言 内部代码 注意```需要闭合 ``` 貌似三个波浪号也可以~~~ ~~~ ``` ### 链接 - **行内式链接**：`[链接文本](链接地址 "可选标题")`，例如：[百度](https://www.baidu.com "百度首页") - **参考式链接**： ``` ```markdown [链接文本][链接标识] [链接标识]: 链接地址 "可选标题" ``` *** ## 引用 ```markdown > 这是一段引用文本 > 引用可以有多行 > 若有多段引用，可在每段前加 > 符号。 > 嵌套块引用 ``` 块引用可以嵌套。在要嵌套的段落前添加一个 >> 符号。 块引用可以包含其他 Markdown 格式的元素。但并非所有元素都可以使用 我已经验证了强调和段落换行表格可以用 ​```markdown > 这是一段引用文本 > 引用可以嵌套 > > 我继续引用 > > > > > 我还引用 ``` > 这是一段引用文本 > 引用可以嵌套 > > 我继续引用 > > > > > 我还引用 > > > > > > *** ## 分割 ``` --- *** ___ ``` 以上三种写法都可生成一条分隔线。 *** ## 列表 ### 有序列表 要创建有序列表，请在每个列表项前添加数字并紧跟一个英文句点。 数字不必按数学顺序排列，但是列表应当以数字 1 起始。 ​```markdown 1. 列表项1 2. 列表项2 1. 子列表项1 2. 子列表项2 3. 列表项3 ``` ### 无序列表 要创建无序列表，请在每个列表项前面添加破折号 (-)、星号 (*) 或加号 (+) 。 缩进一个或多个列表项可创建嵌套列表。 ```markdown - 列表项1 - 子列表项1 - 子列表项2 + 列表项2 * 列表项3 ``` ### 列表中来回嵌套的问题 在如果需要列表中嵌套其他元素，基本所有都可以，甚至图片，拿代码块举例子 要在保留列表连续性的同时在列表中添加另一种元素，请将该元素缩进四个空格或一个制表符 ```markdown 1. 列表行1 2. 下面是代码 
    &<html>
      &lt;head>
        &lt;title>Test&lt;/title>
      &lt;/head>
  1. 同样的，列表也可以嵌套列表
1.  列表行1
2.  下面是代码
 
        <html>
          <head>
            <title>Test&lt;/title>
          </head>
 
3.  同样的，列表也可以嵌套列表
***
## 表格
### 基本表格语法
表头与内容分隔：使用 | 来分隔表格的列，表头与表格内容之间通过 --- 分隔，--- 还可用于指定列的对齐方式。  
```markdown
| 表头1 | 表头2 | 表头3 |
| :---: | :-- | --: |
| 居中内容 | 左对齐内容 | 右对齐内容 |
| 第二行数据1 | 第二行数据2 | 第二行数据3 |
表头1 表头2 表头3
居中内容 左对齐内容 右对齐内容
第二行数据1 第二行数据2 第二行数据3

表格内容换行

如果表格内容需要换行，可以直接在 Markdown 源文件中使用 HTML 的
标签。
支持扩展语法的编辑器中，也可以通过在单元格内容中按回车键进行换行，然后适当缩进以保持格式。

| 列1 | 列2 |
| ---- | ---- |
| 长内容 <br> 换行显示 | 其他内容 |
列1 列2
长内容
换行显示		 其他内容

合并单元格

标准 Markdown 语法本身不支持直接合并单元格。
不过，在一些特定的 Markdown 渲染器（如在 Markdown 中嵌入 HTML 时），可以使用 HTML 的

标签来实现。

图片

行内式图片：替代文本
例如：示例图片，换成你自己的图片链接
参考式图片：

![替代文本][图片标识]
[图片标识]: 图片地址 "可选标题"

任务列表

任务列表可以创建带有复选框的项目列表。在支持任务列表的Markdown应用程序中，复选框将显示在内容旁边。
在任务列表项之前添加破折号-和方括号[ ]，并在[ ]前面加上空格。
要选择一个复选框，请在方括号[x]之间添加 x 。

- [x] Write the press release
- [ ] Update the website
- [ ] Contact the media

转义字符

在字符前面添加反斜杠字符 \ ，这样markdown会识别不去执行该符号
例如
* Without the backslash, this would be a bullet in an unordered list.

  • Without the backslash, this would be a bullet in an unordered list. 不加就会被识别成列表

脚注

脚注是对文本的补充说明，在 Markdown 文档中能为特定内容提供额外信息，同时不影响正文的连贯性
创建脚注引用：在需要添加脚注的位置，使用 [^脚注标识] 的形式插入引用。其中，“脚注标识” 可以是数字、字母或其他字符组合，只要在文档内保持唯一即可。
例如：这是一段包含脚注引用的文本 [^1]。
定义脚注内容：在文档的任意位置（通常在文末），使用 [^脚注标识]: 脚注内容 的格式来定义脚注的具体内容。

这是一段包含脚注引用的文本[^1]。  
另一段文本，这里也可以添加脚注引用[^footnote]。  
[^1]: 这是脚注的具体内容，它可以包含多行文本，用于对正文中相关内容进行详细解释或补充说明。  
[^footnote]: 这是另一个脚注的内容，展示了不同标识的脚注定义方式。

内嵌html代码

对于 Markdown 涵盖范围之外的标签，都可以直接在文件里面用 HTML 本身。
如需使用 HTML，不需要额外标注这是 HTML 或是 Markdown，只需 HTML 标签添加到Markdown 文本中即可
html里面咋用，在这里就可以咋用

插入表情符号

可以简单地从Emojipedia 等来源复制表情符号并将其粘贴到文档中。
许多Markdown应用程序会自动以Markdown格式的文本显示表情符号。从Markdown应用程序导出的HTML和PDF文件应显示表情符号。

posted @   ErgouTree  阅读(80)  评论(1)  编辑  收藏  举报
相关博文：
· Java难绷知识04——异常处理中的finally块
· Java难绷知识03——包装器类及其自动装箱和拆箱
· Markdown 学习笔记
· markdown基本语法
· MarkDown语法说明
阅读排行：
· 全程不用写代码，我用AI程序员写了一个飞机大战
· DeepSeek 开源周回顾「GitHub 热点速览」
· 记一次.NET内存居高不下排查解决与启示
· 物流快递公司核心技术能力-地址解析分单基础技术分享
· .NET10 - 预览版1新功能体验（一）
返回顶端
点击右上角即可分享
微信分享提示
AI FOR CODE 大赛
✽
✽
✽
✽