html是纯标记语言，仅定义网页语义结构，不处理逻辑或样式；必须以开头，正确使用语义标签、lang属性、alt属性及自闭合标签规范。

HTML 是定义网页结构的纯标记语言，不是编程语言，也不处理逻辑或样式——它只负责告诉浏览器“这是标题”“那里是一张图”“这段是导航栏”。

HTML 标签不是命令，而是语义声明

比如 <h1></h1> 不代表“把字变大”，而是声明“这是一级主标题”；<nav></nav> 不是“画个导航栏”，而是说“这部分内容在逻辑上属于导航区域”。浏览器、搜索引擎、屏幕阅读器都靠这些标签理解内容意图。

常见错误现象：

• 用 <div> 堆出所有结构，再靠 CSS 强行模拟 <code><header></header> 或 <article></article> —— 语义丢失，SEO 和无障碍支持直接打折
• 把 <p></p> 当换行工具，连续写 <p></p> <p></p> —— 实际应使用 <br>（空元素）或 CSS 的 margin
• 忽略 lang 属性，如 —— 影响语音合成、拼写检查、字体回退

HTML5 文档必须以 开头

没有这个声明，浏览器会进入“怪异模式（Quirks Mode）”，CSS 盒模型、表单默认样式、Flex 布局行为全可能错乱。它不区分大小写，但必须是第一行、无空格、无注释前缀。


html-to-pptx-converter
使用 PptxGenJS 和 Python 解析，将结构化的 HTML/CSS 幻灯片内容转换为原生、可编辑的 PowerPoint（.pptx）演示文稿。
下载

正确写法只有一种：。别写 <code>、<code> 或加 XML 声明。

顺带一提： 中的 lang 值推荐用 IETF 语言标签（如 zh-Hans 表简体中文），比 zh-CN 更准确，但后者目前兼容性更好。

<img> 必须有 alt 属性，且不能留空除非真无意义

alt 不是“图片说明可选字段”，而是图像的文本等价物。缺失时，屏幕阅读器会读出文件名（如 IMG_20240501.jpg），搜索引擎无法理解图中内容，img 元素在 DOM 中也会被降权。

使用场景判断：

• 图标类小图（如按钮上的 ✅）、纯装饰图 → alt=""（空字符串，不是省略）
• 信息图、产品图、截图 → 用一句话描述核心信息，不含“图中/照片显示”等冗余词，例如 alt="MacBook Pro 16英寸开盖状态，屏幕显示终端命令行界面"
• 复杂图表 → 用 <figure><figcaption></figcaption></figure> 配合长描述，alt 只写概要

自闭合标签写法：HTML 不强制斜杠，但建议统一风格

<img src="a.jpg" alt="a"> 和 <img src="a.jpg" alt="a"> 在 HTML5 中都合法。XHTML 要求后者，但现代 HTML 解析器不认斜杠是否出现。

容易踩的坑：

• 混用风格：同一项目里有的写 <br>，有的写 <hr> —— 团队协作和代码审查时易引发争议
• 误以为 <input> 加斜杠能触发某种行为 —— 它只是语法糖，不影响功能或事件绑定
• 在模板引擎（如 Vue/JSX）中照搬 HTML 写法，却忘了 JSX 要求所有标签闭合（<img>），否则报错

真正关键的是保持一致：选 <img> 就全用，选 <img> 就全用。别让格式问题掩盖语义缺陷。