code标签专用于标记单行、内联、上下文依赖的技术标识符,如函数名、css属性、命令等;多行代码应使用pre+code,ui文字或伪代码不可滥用;必须转义html字符,避免嵌套,确保语义真实准确。

code 标签不是为了“让代码看起来像代码”,而是为了告诉浏览器、搜索引擎和屏幕阅读器:“这段文本是程序代码,不是普通文字”。用错地方,语义就塌了。
什么时候该用 code,而不是 或 <div>
<p>只用于**单行、内联、上下文依赖的技术文本**。比如你在段落里提到了一个函数名、一个 CSS 属性、一条命令,就得包一层 <code>code</code>:</p><div class="aritcle_card flexRow artxards">
<div class="artcardd flexRow">
<a class="aritcle_card_img" rel="nofollow" href="/xiazai/skill2900" title="Markdown to HTML"><img
src="https://img.php.cn/upload/skill/000/000/081/178938727468962.jpg" alt="Markdown to HTML" onerror="this.onerror='';this.src='/static/lhimages/moren/morentu.png'" ></a>
<div class="aritcle_card_info flexColumn">
<a rel="nofollow" href="/xiazai/skill2900" title="Markdown to HTML" class="overflowclass">Markdown to HTML</a>
<p class="overflowclass">{"answer":"将 Markdown 转换为内嵌 CSS、样式精美的独立 HTML。完美适用于新闻简报、文档、报告及邮件模板。"}</p>
</div>
<a rel="nofollow" href="/xiazai/skill2900" title="Markdown to HTML" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span>
</a>
</div>
</div>
<ul>
<li>✅ 正确:<code>parseInt()</code> 会把字符串转成整数</li>
<li>✅ 正确:设置 <code>display: flex</code> 启用弹性布局</li>
<li>✅ 正确:运行 <code>npm install --save-dev jest</code> 安装测试依赖</li>
<li>❌ 错误:<code>function foo() { return true; }</code>(多行函数体,应改用 <pre class="brush:php;toolbar:false;"><pre class="brush:php;toolbar:false;">)
点击【提交】按钮(UI 文字,不属于源码)
code 必须转义 HTML 字符,否则会解析失败
如果你直接写 <div class="app">,浏览器会把它当标签解析,页面就乱了。必须先做 HTML 实体转义:
<ul>
<li>✅ 正确:<code><div class="app">
<div class="app">(未转义,实际渲染为空或破坏结构)
<li>工具建议:用 <code>DOMPurify.sanitize() 或服务端模板引擎的自动转义功能,别手写嵌套 、 等标签能提升语义精度
code 表示的是“标识符”本身,不是变量含义或用户操作。混用其他语义标签才能表达完整意图:
- ✅
Math.PI —— 表示数学变量,表示命名空间下的属性名
- ✅ 按 Ctrl+Shift+I 打开开发者工具,再查看
console.log() 输出 - ✅ 错误信息 ReferenceError:
foois not defined —— 表示程序输出,包裹其中的标识符
- ⚠️ 避免嵌套
code 在 <code>code里,没有语义依据,纯属视觉堆砌
最容易被忽略的是:语义不是“加了标签就生效”,而在于是否与上下文一致。比如文档里写“调用 fetch() 方法”,如果这个 fetch() 其实是伪代码或已被废弃的 polyfill 名,那它就不该用 code——语义要求真实、准确、可验证。










