点开那篇文章的编辑器,页面上只有一个灰色的方块。
方块上写着「自定义 HTML」。
点进去,第一个字符是 <!DOCTYPE html>。
🔍 当时怎么想的
那篇是 OMaster 的项目介绍,四千多字。素材来自 GitHub 仓库的 README,写得挺完整,我不想重写一遍,就想整段搬过来。
README 用 Markdown 写的,但我知道 Markdown 粘进 WordPress 会丢掉所有样式。于是我换了个思路:在 GitHub 页面上把渲染好的 HTML 复制下来。
在浏览器里看是好的。粘进后台,在编辑器里也是好的。发布出来,也是好的。
好了一年。
💥 四个后果
一、整个文档嵌进了页面里
粘进去的不是「一段 HTML 片段」,是一个完整的 HTML 文档。
<!DOCTYPE html>、<html>、<head>、<meta charset>、<title>,一个不少。
浏览器对这种情况很宽容,会忽略掉多余的标签,把它当片段渲染。所以肉眼看不出来。但它意味着这篇文章的 DOM 结构是错的——页面的 <body> 里套了另一个文档的头。
二、<style> 块在污染整站
那份 HTML 里带了一段 <style>,摘几条出来:
body { max-width: 800px; margin: 0 auto; padding: 20px; }
h2 { border-bottom: 1px solid #eee; }
img { border-radius: 8px; }
这段样式没有作用域。它不会只影响这篇文章,它会覆盖整站所有页面的 body、h2、img。
也就是说,我那篇文章发布的那天起,我的博客主页、分类页、归档页,所有的 body 都被强行压成了 800px 宽。主题自己的布局设置在跟这段内联样式打架,谁后加载谁赢。
我一年都没发现。
三、相对路径的图片全是 404
文章里第一个 <img> 的地址是:
/app/src/main/ic_launcher-playstore.png
这是 GitHub 仓库里的相对路径。在 GitHub 上它能显示,因为那是在仓库根目录下解析的。
在博客上,/app/... 会被解析成 https://fky.ltd/app/src/main/ic_launcher-playstore.png。
那是我网站的根目录。那里没有这个文件。
那个 App 图标,在我的博客上挂了一年 404。
四、后台没法改
这是最要命的一条。
整个正文是一个区块。想在中间加一句话,得在这一万一千多个字节里找到位置,手动插一段 <p>。
改完如果标签没闭合,整篇排版直接崩,而且不容易看出崩在哪。
🧪 正确做法是原生区块
WordPress 的区块编辑器(Gutenberg)把内容存成带注释的区块。同一个标题,原生格式长这样:
<!-- wp:heading {"level":2} -->
<h2 class="wp-block-heading">核心功能</h2>
<!-- /wp:heading -->
一段话:
<!-- wp:paragraph -->
<p>纯本地存储,不上传任何数据。</p>
<!-- /wp:paragraph -->
好处是每一块都能独立编辑、独立移动、独立改样式。样式由主题统一控制,不会再出现内联 <style> 跟主题抢权的情况。
我现在的写作流程是 Markdown 进、原生区块出。转换器把 ## 变成 heading 块,把普通段落变成 paragraph 块,代码块变成 code 块。
📊 差别在哪
| 那份搬来的 HTML | 原生区块 | |
|---|---|---|
| 区块数 | 1 个 | 十几到几十个 |
| 后台编辑 | 改整块 | 逐段改 |
| 样式冲突 | 内联 <style> 覆盖全站 | 由主题控制 |
| 段落出错 | 整篇崩 | 只崩一块 |
| 搜索摘要 | 提取困难 | 正常 |
🧭 一句话
Markdown 是给人读的,HTML 是给浏览器读的,区块是给编辑器读的。
把三者搞混,代价是一年后你打开后台,发现自己写的东西已经改不动了。
那篇文章我打算找时间重排一遍。四千多字,值得重新做成能编辑的样子。