Markdown 语法

Markdown 标题怎么写?
(# 一级到六级,以及为什么不生效)

你想要一个 Markdown 标题——段落上方一行大大的标题,但打了 # 却没变成标题。标题是用 # 号写的,而它不生效最常见的原因就是少了空格。这里讲全六级怎么写、以及怎么避开常见的坑。

# 标题写法(一级到六级)

在一行开头放一个或多个 # 号,然后一个空格,再写文字。# 的数量就是标题级别。

你写 得到
# 标题 一级(最大)
## 标题 二级
### 标题 三级
#### 标题 四级
##### 标题 五级
###### 标题 六级(最小)

所以一个 # 是最大的标题(一级)、六个是最小的(六级)。这是标准写法,叫 ATX 标题。

标题不生效的头号原因:少了空格

几乎人人都栽过。# 和文字之间必须有一个空格

#标题    → 还是普通文字(没空格)
# 标题   → 渲染成标题

如果你的标题显示成前面带个 # 的普通一行,在 # 后补一个空格就会渲染了。

另一种写法:下划线式标题(=== 和 ---)

Markdown 还有第二种标题写法,叫 Setext:写完文字,在下一行给它加下划线

一级标题
=========

二级标题
---------

一排 = 把上面那行变成一级、一排 - 变成二级。它只能做这两级,渲染出来和 ### 一样。

有个细节值得知道:单个 -= 不够,所以下面只写一个短横的那行会被当成普通段落、不是标题。

小心:这就是分割线会变成标题的原因

因为 --- 紧贴文字下方会被读成二级标题的下划线,你本想画的分割线可能会不小心把上面那行变成标题。解决办法是在文字和 --- 之间留一个空行。完整讲解看 Markdown 分隔线怎么画

看到标题渲染出来

在纯文本编辑器里你只看到 # 符号。想看到真正带级别的标题,用 Markdown 编辑器打开那个 .md

  1. 用 Chrome / Edge / Arc 打开 app.noteloom.cc、挂载装文件的文件夹。
  2. reading 视图里打开 .md 看标题渲染,或用 live 视图边写边预览。
  3. 文件在磁盘上仍是纯 .md;什么都不上传。

FAQ

Markdown 标题怎么写?
一行以 # 开头、加一个空格、再写文字:# 标题。加更多 # 变小级别、最多 ###### 是六级标题。# 后的空格是必须的。
我的 #标题 为什么显示成普通文字?
几乎都是少了空格。#标题(无空格)不是标题、还是普通段落;# 标题(# 后有空格)才是。补上空格就渲染了。
Markdown 有几级标题?
六级,从一级到六级,用一到六个 # 写。大多数工具把一级排得最大、六级最小,就像文档大纲里的标题层级。
# 和 === 标题有什么区别?
渲染结果一样。#(叫 ATX)能写全部六级、是常用写法。用 ===(一级)或 ---(二级)给文字加下划线(叫 Setext)只能做这两级。
我的 --- 为什么把上面那行变成了标题?
因为 --- 紧贴文字下方会被当成 Setext 二级标题的下划线,上面那行就变成标题。在文字和 --- 之间留一个空行,或看分割线那篇。
NoteLoom 能显示 Markdown 标题吗?
能。它的 reading 和 live 视图把 # 标题(以及 ===/--- Setext 标题)渲染成带级别的标题,直接来自你本地的 .md 文件,什么都不上传。

看到你的标题渲染出来

.md 文件里写你的 # 标题,用 Chrome / Edge / Arc 打开 NoteLoom、挂载文件夹,在 reading 视图里读——每个标题都带着级别、排好版。不用装、不用账号。

打开 NoteLoom 试试