H1 标题,用于主标题还是一级小标题?

Markdown 的 H1 标题 #,大家是习惯用于文章的主标题还是第一级小标题?

我大多数时候是 主标题用 H1 或无格式;小标题始于 H2。不过,有时又纠结于小标题用 H1……

尽管哪种选择都无大碍,但还是想借鉴一下大家的作法,统一自己的笔记格式。

2 个赞

我换新电脑转移笔记时,发现在新电脑上,转移过来的笔记自动多了一个H1的主标题,不知道是怎么回事,这是从旧电脑的obsidian转移到新电脑的obsidian的效果:

从此之后我第一级标题都只用H2了,一般不用H1,主标题就只是mk文件名字

这么一说我就不纠结了,也继续沿用 H2 开头吧~

之前纠结也是因为在某象笔记里,就算 H1 缺失,它的大纲目录也是以空白占位的,看着难受。现在发现 Ob 并没有这样。

网上有很多最佳实践,都提倡一篇文档只有一个H1。比如:Markdown best practices - PowerShell | Microsoft Learn

1 个赞
  • Only one H1 per document
  • Header levels should increment by one – don’t skip levels

确实,大佬们的意见都蛮统一的,学习了

我在文档里也把主标题给写上,毕竟之前遇过系统发癫把文档名变乱码的情况(里面的内容倒是没事)。

因为ob1.0之后在外观里新增了一个默认开启的设置选项叫做显示页内标题,不手动关闭的话就会这样。

怪不得,不过我还是别关了,因为除了一级标题,文内没有跳标题的情况,怕关了出现乱码啥的

取决于自己的使用场景。

  • 以前,笔记自用,不需要篇标题。所以,会出现 n 个 H1。
  • 最近,为了方便 Obsidian publish 读者,就修改了规则:关闭 Obsidian Publish 把文件名显示为 H1 的功能;手工写 H1 作为篇标题,正文的标题就从 H2 开始了 。
1 个赞

h2 标题显示的还是比较大,我一般从 h3 开始,大小合适,如果后面还有更高级的标题在用 h2,尽量不使用 h1

笔记自用 H几都没关系。大小可以自己改css,反而用H1还可以少打#

参考了大家的答复,我现在的做法是:主标题无格式,小标题从 H2 开始。这么做主要考虑笔记的迁移和适应性。
确实,每个人都有自己的标准,取决于使用场景。

1 个赞

这个问题在部署博客的时候也会遇到,很多博客和主题,为了兼容 md,采取隐藏 H1的方式。

如果频繁使用 H1作为标题,会引起迁移成本。考虑多平台的兼容性,遵循一个 md 只有一个H1 的原则。

我打标题都用快捷键的, 把H1快捷键删了, H2是ctrl+1, 以此类推,还通过修改css在H2标题前显示H1方便知道层级. 现在ob支持文件名称作为H1显示, 所以我的H1彻底雪藏了

H1 用作 title. 用了 linter 插件, 会自动找到 H1 并存储到 frontmatter 中。

还没有考虑到转移数据的问题, 但是仍然保持单一 H1 的习惯。