Obsidian嵌入/引用笔记的标题层级自动调整需求

实现思路与步骤 #

路径一：用现成插件快速解决（推荐新手）

Obsidian社区有专门处理嵌入标题层级的插件，比如Embed Heading Levels（可在社区插件商店搜索安装），核心用法如下：

• 安装并启用插件后，嵌入笔记时用![[笔记名称|offset=N]]语法，N为层级偏移量：比如在## 二级标题下嵌入笔记，要让笔记标题显示为### 三级标题，就用![[笔记名称|offset=1]]（原笔记标题层级+1）；部分插件还支持![[笔记名称|level=2]]直接指定目标层级。
• 插件会自动调整嵌入笔记内部所有标题的层级，包括嵌套的嵌入笔记，完全匹配你的需求。

路径二：自定义CSS+JS实现（适合个性化需求）

如果找不到完全匹配的插件，可以用CSS片段配合Custom JS插件实现，步骤如下：

步骤1：安装Custom JS插件

在社区插件商店搜索并安装Custom JS，启用后在插件设置里指定脚本文件夹（默认是Vault/.obsidian/customjs/）。

步骤2：编写JS脚本处理嵌入参数

在上述文件夹新建embed-heading-levels.js，写入代码：

// 监听嵌入块加载，解析层级参数并添加标记
const observer = new MutationObserver((mutations) => {
  mutations.forEach(mutation => {
    mutation.addedNodes.forEach(node => {
      if (!node.classList?.contains('markdown-embed')) return;
      
      const link = node.querySelector('.markdown-embed-link');
      if (!link) return;
      const [_, param] = link.getAttribute('href').split('|');
      if (!param || !param.startsWith('h')) return;
      
      // 给嵌入块添加层级标记
      node.setAttribute('data-embed-level', param);
      
      // 替换嵌入标题的标签为指定层级
      const title = node.querySelector('.markdown-embed-title');
      if (title) {
        const newTitle = document.createElement(param);
        newTitle.textContent = title.textContent;
        newTitle.className = 'markdown-embed-title';
        title.replaceWith(newTitle);
      }
    });
  });
});

// 启动监听
observer.observe(document.body, { childList: true, subtree: true });

步骤3：编写CSS片段调整标题样式

在Vault/.obsidian/snippets/文件夹新建embed-heading-adjust.css，写入代码：

/* 定义各级标题样式变量（和Obsidian主题对齐） */
:root {
  --h1-size: 2em;
  --h1-weight: 700;
  --h2-size: 1.75em;
  --h2-weight: 700;
  --h3-size: 1.5em;
  --h3-weight: 600;
  --h4-size: 1.25em;
  --h4-weight: 600;
  --h5-size: 1.1em;
  --h5-weight: 600;
  --h6-size: 1em;
  --h6-weight: 600;
}

/* 层级h2的嵌入块：原h1→h2样式，原h2→h3样式 */
.markdown-embed[data-embed-level="h2"] .markdown-embed-content h1 {
  font-size: var(--h2-size);
  font-weight: var(--h2-weight);
  margin: 1em 0 0.5em;
}
.markdown-embed[data-embed-level="h2"] .markdown-embed-content h2 {
  font-size: var(--h3-size);
  font-weight: var(--h3-weight);
  margin: 0.8em 0 0.4em;
}
.markdown-embed[data-embed-level="h2"] .markdown-embed-content h3 {
  font-size: var(--h4-size);
  font-weight: var(--h4-weight);
}

/* 层级h3的嵌入块：原h1→h3样式，以此类推 */
.markdown-embed[data-embed-level="h3"] .markdown-embed-content h1 {
  font-size: var(--h3-size);
  font-weight: var(--h3-weight);
}
.markdown-embed[data-embed-level="h3"] .markdown-embed-content h2 {
  font-size: var(--h4-size);
  font-weight: var(--h4-weight);
}
/* 可继续补充h4-h6的规则 */

步骤4：启用脚本和CSS片段

• 在Custom JS插件设置里启用embed-heading-levels.js
• 在Obsidian“设置→外观→CSS片段”里启用embed-heading-adjust.css

用法

嵌入笔记时用![[笔记名称|h2]]语法，即可让笔记标题显示为h2层级，内部所有标题自动向下偏移一级，嵌套的嵌入笔记也会自动应用相同规则。

内容的提问来源于stack exchange，提问作者Benito K