阅读模式触发依赖HTML语义结构而非CSS或JS：必须有且仅有一个置于<main>内的<h1>，<main>不得嵌套在<header>/<nav>中，正文须用<section><h2>等层级化标签组织，<img>需带alt、<blockquote>需含cite、列表须用<ul>/<ol>包裹。
浏览器阅读模式不是靠 JS 删除广告，而是靠 HTML 结构“提前告诉”浏览器哪部分是正文。结构不对，再漂亮的 CSS 或再多的 JS 都没用。
为什么 Safari/Firefox/Edge 有时不显示阅读模式图标
根本原因不是页面太短或含视频，而是语义结构缺失或冲突。阅读器（如 Safari 的 Reader、Firefox 的 Readability）会扫描 DOM，一旦发现以下情况，直接放弃解析：
-
<main>或<article>缺失，或被嵌套在<header>/<nav>/<aside>内部 - 页面没有
<h1>，或<h2>出现在<body>下且前面无<h1> - 正文内容散落在多个同级
<div class="content">中，没有统一包裹容器 -
<img>没有alt属性，<blockquote>缺cite，列表项未用<ul>/<ol>包裹
必须写的三个标签：<main>、<h1>、<section>
这不是“推荐写法”，而是阅读器识别正文的硬性信号。它们共同构成最小可触发结构：
-
<main>必须存在且唯一，不能嵌套在<header>、<footer>、<nav>中；它应直接子元素为<article>或<section> -
<h1>必须有且仅有一个，放在<main>内最顶部，对应文章主标题；不可用<div class="title">+ CSS 替代 -
<section>用于划分小节，每个<section>内建议以<h2>开头；子小节用<h3>，禁止跳级（如<h1>后直接<h3>）
示例最小有效结构：
立即学习“前端免费学习笔记（深入）”；
html-to-pptx-converter
下载
使用 PptxGenJS 和 Python 解析，将结构化的 HTML/CSS 幻灯片内容转换为原生、可编辑的 PowerPoint（.pptx）演示文稿。
<main>
<h1>如何写好 HTML 阅读模式</h1>
<section>
<h2>标题层级必须严格</h2>
<p>…正文内容…</p>
</section>
<section>
<h2>图片和引用要带语义</h2>
<img src="diagram.png" alt="结构对比示意图">
<blockquote cite="https://webkit.org/blog/12345"><p>Readability relies on structure, not style.</p></blockquote>
</section>
</main>
图片、引用、列表怎么写才不被砍掉
阅读器对非文本节点极其敏感——不是“渲染不出来”，而是“直接整块丢弃”。关键不在是否可见，而在是否提供机器可读的语义：
-
<img>必须带alt，哪怕只是空字符串alt=""；若为装饰图，显式写alt=""，不要省略 -
<blockquote>必须含cite属性（URL 或作者名），且内部必须用<p>包裹文字，不能直接放纯文本 - 列表必须用
<ul>或<ol>，每个条目必须是<li>；禁止用<div>+::before模拟项目符号 -
<figure>+<figcaption>是安全组合，比裸<img>更易被保留
Chrome 怎么启用阅读模式（以及为什么常失败）
Chrome 原生不支持阅读模式，需手动开启实验功能：chrome://flags/#reader-mode → 设为 Enabled → 重启。但即使开启，仍常失败，原因很实际：
- 该功能依赖 Blink 引擎的 DOM 分析，对动态渲染（如 React/Vue SSR 后 hydrate）支持弱，常在 JS 执行前就已判断完毕
- 若页面用了
display: none或visibility: hidden隐藏正文初始内容，阅读器会直接跳过该节点 - 第三方脚本（如广告 SDK、统计代码）插入的
<div>若与正文同级且无语义，可能干扰结构权重计算
真正可靠的做法不是等 Chrome 自动识别，而是从源头写对结构——<main>、<h1>、<section> 这三样写对了，Safari 和 Firefox 几乎 100% 触发，Chrome 开启 flag 后成功率也大幅上升。
最容易被忽略的点：阅读模式不是“样式开关”，它是基于 DOM 结构的静态分析结果。改完 HTML 后别只看浏览器渲染效果，务必用浏览器开发者工具检查 <main> 是否真的包裹了全部正文、<h1> 是否在它内部、所有 <img> 是否都有 alt——这些才是决定阅读模式能否出现的硬条件。
