我把一整个 HTML 文档粘进了 WordPress 文章里

silas 发布于 7 天前 52 次阅读 技术复盘


点开那篇文章的编辑器,页面上只有一个灰色的方块。

方块上写着「自定义 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 是给浏览器读的,区块是给编辑器读的。

把三者搞混,代价是一年后你打开后台,发现自己写的东西已经改不动了。

那篇文章我打算找时间重排一遍。四千多字,值得重新做成能编辑的样子。