
代码区块用于展示代码文本,自定义HTML用于输出页面标记,二者目的不同。写教程需要让读者看见并复制示例时,应使用合适的代码展示方式,并检查特殊字符没有被编辑器当成页面结构执行。
按读者需要选择区块
介绍标签写法、配置示例或命令时,重点是保留原字符与换行。真正需要插入一段页面组件时,才考虑自定义HTML及对应安全规则。不要为了显示彩色语法就把示例直接放进HTML区块,使标签变成页面实际元素。
保留示例语法但去除敏感值
代码中的引号、尖括号和空格可能影响意义,复制后应仍是预期文本。使用清晰占位符替代真实令牌、地址或个人资料,并说明哪些值需要替换。排版工具自动变成弯引号可能让命令失效,需回读复制结果。

区分前端渲染与服务端执行
浏览器可解析HTML及允许的脚本,不代表WordPress正文可以执行PHP。账号能力和内容过滤也可能移除某些标记。不要用关闭全站过滤或随意增加高权限来解决教程展示问题,先确认是否选错了内容区块。
验证页面阅读与实际复制
公开页检查是否出现意外表单、空白元素或脚本行为,再复制示例到纯文本环境比较。长代码应在手机上可阅读且不撑破页面,可采用合理横向滚动。说明示例用途与运行前提,不把展示正常当作代码已经经过实际运行测试。
关键区别

代码区块:显示代码文字;不是执行入口。
自定义HTML:输出页面标记;受权限与过滤影响。
PHP示例:解释服务器代码;正文不能据此执行。
怎样确认处理到位
代码作为文本完整显示,复制后字符正确,页面无意外执行或结构破坏,手机阅读及敏感值脱敏均通过。
容易误判的边界
本文不宣称示例已在所有环境运行;代码展示效果、语法有效性和业务执行结果应分别验证。
