Markdown 标题
在行首写 # 和一个空格就是标题:一个 # 是文档标题,## 是章节,最多六级。本文介绍各级标题、下划线写法、标题 id 和常见错误。
简短回答
Markdown 怎么写标题?
在行首写一到六个 #,后面加一个空格:# 标题 最大,###### 注释 最小,分别生成 HTML 的 <h1> 到 <h6>。文档标题用一个 #,章节用 ##。
Markdown
# 文档标题
## 章节
### 小节显示效果
文档标题
章节
小节
标题的写法和示例
# 的个数决定标题级别,另外几个细节决定这一行能不能成为标题。
六级标题
每多一个 # 就低一级,大多数文档只需要前三级。
Markdown
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题显示效果
一级标题
二级标题
三级标题
四级标题
五级标题
六级标题
井号后面要有空格
没有空格时,这一行仍然是普通段落。
Markdown
#没有空格不是标题
# 有空格才是标题显示效果
#没有空格不是标题
有空格才是标题
下划线式标题
文字下面一行写 = 或 -,分别是一级和二级标题。这种写法只有这两级。
Markdown
文档标题
========
章节标题
--------显示效果
文档标题
章节标题
结尾的井号
文字后面的 # 可写可不写,不会显示在标题里。
Markdown
## 安装 ##显示效果
安装
标题里的格式
标题里可以有加粗、行内代码和链接。
Markdown
### `--force` 参数
### [2.0 版](https://example.com/v2)的**不兼容**改动显示效果
--force 参数2.0 版的不兼容改动
自定义标题 id
Pandoc、Hugo 和 kramdown 支持在标题后面用花括号写 id,# 链接可以指向它。
Markdown
## 安装 {#install}
[跳到安装](#install)仅适用于 Pandoc、Hugo 和 kramdown。其他 Markdown 应用的显示效果不同,因此不提供预览。
各平台的标题支持
# 标题几乎处处可用,聊天软件支持的级别更少或不支持。
| 应用 | 支持情况 | 说明 |
|---|---|---|
| GitHub / GitLab | 支持 | 支持六级标题,每个标题都有可供 # 链接跳转的 id。 |
| Discord | 有差异 | 消息里支持 #、##、###,-# 是灰色小字。 |
| Slack | 不支持 | 消息没有标题,可以用加粗代替。 |
| Obsidian | 支持 | 支持六级标题,标题可以折叠,[[笔记#标题]] 可以链接到标题。 |
| Notion | 有差异 | 输入 #、## 或 ### 加空格会生成标题块。 |
| Typora | 支持 | 支持六级标题,侧边栏显示大纲。 |
常见问题
Markdown 有几级标题?
六级:从
# 的一级标题到 ###### 的六级标题,对应 HTML 的 <h1> 到 <h6>。为什么标题没有生效?
# 后面要有空格(写 # 标题,不要写 #标题),并且 # 要在行首。前面缩进四个或更多空格时,这一行会变成代码。怎样链接到某个标题?
用
# 加标题的 id:[安装](#安装)。GitHub 把标题文字转成小写、空格换成连字符作为 id,中文会保留。怎样生成目录?
可以手写指向各个标题的链接列表,也可以用 Markdown 目录生成器根据标题自动生成。
一篇文档只能有一个一级标题吗?
通常的约定是只用一个一级标题做文档标题,章节从
## 开始。很多网站已经把页面标题显示成标题,给这些网站写的文档会直接从 ## 开始。能给标题设置自己的 id 吗?
CommonMark 和 GitHub 不支持。Pandoc、Hugo 和 kramdown 支持
## 标题 {#my-id} 的写法。# 标题和下划线式标题有什么区别?
# 标题和下划线式标题有什么区别?一级和二级标题的效果相同。下划线式标题最多只有两级,
# 标题更常用,在源码里也更醒目。Discord 里怎么写标题?
在行首写
#、## 或 ### 加空格。-# 加空格是灰色小字。