语义化引用必须同时使用和，cite提供机器可读来源URL，footer呈现人类可读署名；长引用需嵌套保留格式；行内短引用用而非。

blockquote 必须带 cite 属性，否则不是语义化引用

只写

文字

是错的。浏览器和读屏器不认为这是真实引用，Lighthouse 会报可访问性问题，SEO 也不识别来源。cite 属性必须填合法 URL（如 https://example.com/article/42），不能是空字符串、相对路径或中文描述。

常见错误现象：
– 页面里一堆

但没 cite，被当成装饰性缩进
– 填了 cite="张三《前端手册》" —— 这不是 URL，无效
– 复制公众号文章后全塞进一个

，无出处、无机器可读标识

• 正确做法：每个
  对应一个明确外部来源，cite 指向该来源唯一 URL
• 如果引用来自本地 PDF 或未上线文档，先上传到公开可访问地址再填 URL
• 多个段落直接用
  套在
  内，别用
或空行模拟

footer 必须显式标注作者、书名、年份等可见信息

是用户看得见的署名区，不是可选配件。它和 cite 属性分工明确：cite 供机器读取，

供人阅读。两者同时存在才是完整引用。

典型误用：
– 只写

— 来源：某公众号

，没作者、没时间、没作品名
– 把整段引用包在 里：

...

—— 只能用于作品名，比如书名或文章标题

• 推荐格式：
  — 李四，《现代 Web 开发》，2025 年第 2 版，第 87 页
• 如果引用自网页，
  里可用 包裹标题，如：
  — 王五，CSS Grid 实战指南，MDN Web Docs，2026
• 避免在
  里放链接 —— 那是 cite 的职责；也别用 包住整个

长引用含代码、诗歌或终端输出时，必须嵌套 pre+code

普通

会合并空白符，导致缩进丢失、换行错乱。遇到依赖格式的内容（如 JSON 片段、命令行输出、古诗排版），不能靠敲空格或
强行对齐。

Convert Markdown To HTML And PDF - Markdown和HTML、PDF互转

实现 Markdown↔ HTML 互转，支持导出 PDF，用于用户请求的文档格式转换。

下载

错误示例：
– 把一段 Python 代码直接塞进

里，缩进全塌陷
– 用多个   模拟诗歌空格 —— 响应式下完全不可控

• 正确组合：

  <code>{ "status": "ok", "data": [] }</code>

  — RFC 8259, Section 2, 2017

• 保留原始换行与空格， 表明这是计算机内容（利于语法高亮和可访问性）
• 建议加 class 控制字体，例如
  ，再用 CSS 设 font-family: monospace

别把 q 当成短版 blockquote 来滥用

是为行内一句话引用设计的，比如对话、格言、术语定义。它由浏览器自动添加引号（支持 CSS 自定义样式），语义清晰且轻量。硬套

反而破坏结构。

典型场景踩坑：
– 在段落中写“他说：

今天上线

”——这会让 DOM 层级混乱，屏幕阅读器误判为独立区块
– 把列表项里的引文全用

包裹，只为视觉缩进

• 该用 的情况：

  文档指出：“所有 API 必须返回 JSON”。

• 不要给 加 cite 属性 —— 它不支持；需要出处时，改用
  + footer
• 如果引用内容含标点（如句号在引号内）， 会自动处理，无需手动加引号

最常被忽略的一点：blockquote 不是样式工具。缩进、边框、背景色这些都该交给 CSS，而不是靠嵌套多个 blockquote 或加空

来凑效果。语义归语义，表现归表现，混着用迟早出 accessibility 和 SEO 问题。

前端入门到VUE实战笔记：立即使用
在学习笔记中，你将探索 前端 的入门与实战技巧！