必须用而非等宽字体的三个条件:文本是程序自动生成的原始字符串、真实出现在用户代理界面中、上下文明确指向“这是输出”;多行输出须用包裹,且需CSS声明等宽字体与预格式化样式。

标签不是用来“模拟”输出的视觉工具,它只在内容真实对应程序运行后用户直接看到的原始反馈时才合法。用错就等于在语义上撒谎——浏览器和屏幕阅读器会信以为真。
什么时候必须用 ,而不是随便套个等宽字体
三个条件缺一不可:
- 文本是程序执行后**自动生成的字符串**(比如
console.log()打印的、终端命令返回的、错误弹窗里显示的) - 这段文字**真实出现在用户代理界面中**(终端窗口、浏览器控制台、GUI 提示框),不是你编的示例或伪代码
- 上下文明确指向“这是输出”,而非解释、说明、路径、命令或 API 响应体
✅ 正确:Error: Cannot find module 'fs'(Node.js 控制台原样打印)
❌ 错误:{"id":1,"name":"Alice"}(这是服务端返回的 JSON 字符串,该用
)</p>
<H3>多行输出不加 <pre class="brush:php;toolbar:false;"> 就等于没写换行</H3>
<p><samp> 是内联元素,它不保留空格、制表符或换行符。直接写:</p><div class="aritcle_card flexRow">
<div class="artcardd flexRow">
<a class="aritcle_card_img" href="/xiazai/skill9263" title="Html2md"><img
src="https://img.php.cn/upload/skill/000/000/081/179249945220127.jpg" alt="Html2md" ></a>
<div class="aritcle_card_info flexColumn">
<a href="/xiazai/skill9263" title="Html2md">Html2md</a>
<p>使用 Readability + Turndown 将 HTML 页面转换为干净的、Agent 友好的 Markdown。去除导航栏、广告、页脚、Cookie 横幅、社交按钮等干扰元素。支持 URL...</p>
</div>
<a href="/xiazai/skill9263" title="Html2md" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span> </a>
</div>
</div>
<pre class="brush:php;toolbar:false;"><samp>Traceback (most recent call last):
File "main.py", line 3, in <module>
print(undefined_var)
NameError: name 'undefined_var' is not defined</samp>
浏览器会把它压成一行,根本没法读。必须用
包裹:</p>
<pre class="brush:php;toolbar:false;"><pre class="brush:php;toolbar:false;"><samp>Traceback (most recent call last):
File "main.py", line 3, in <module>
print(undefined_var)
NameError: name 'undefined_var' is not defined</samp>
注意:
只负责格式,<samp> 负责语义——不能反过来用 <pre class="brush:php;toolbar:false;"><code> 冒充输出,那只是视觉模仿。</p> <H3>容易被忽略的转义和样式风险</H3> <p>它不做 HTML 转义,也不强制等宽字体:</p> <ul> <li>如果后端返回含 <code><script>的错误信息,直接塞进 就是 XSS 漏洞
samp { font-family: ui-monospace, 'SFMono-Regular', Consolas, monospace; }
white-space: nowrap; overflow-x: auto; 防折断;多行必须配 + <code>white-space: pre-wrap;</code>
onclick 或 tabindex——它不是交互容器,加了反而误导辅助技术
真正难的从来不是怎么写标签,而是判断“这到底算不算用户代理呈现的原始输出”。同一段文本,在调试日志里是 ,在接口文档里就得是 。

















