Python用open()读取UTF-8文本，html.escape()转义特殊字符，加保留换行、包裹段落；Markdown文本优先用pandoc；直接改后缀为.html无效，必须生成合法HTML结构。
用 Python 的 open() 和字符串替换最直接
纯文本转 HTML 不需要框架或外部库，核心就是读入内容、套上基础 HTML 结构、转义特殊字符。很多人一上来就搜“txt 转 html 工具”，其实几行 Python 就能稳稳搞定。
常见错误现象：、<code>&、中文引号在 HTML 里直接显示为乱码或被浏览器解析成标签；空行丢失；制表符变成一堆空格。
- 先用
open('input.txt', encoding='utf-8')读取，明确指定编码，避免UnicodeDecodeError - 对每一行用
html.escape()处理（Python 3.2+ 自带），它会把→ <code><，&→& - 每行结尾加
<br>保留换行，段落之间用<p></p>包裹更语义化 - 别用
str.replace()手动替换尖括号——漏掉&会导致生成的 HTML 不合法
用 pandoc 命令行处理带格式的 txt
如果你的 txt 文件实际是 Markdown 风格（比如有 # 标题、- 列表、代码块缩进），硬套 <br> 就丢结构了。pandoc 是这时候真正省事的选择。
立即学习“前端免费学习笔记（深入）”；
使用场景：笔记导出、README 草稿转网页、带层级的说明文档。
- 安装后执行：
pandoc input.txt -o output.html，默认识别 Markdown - 如果 txt 是纯文本文档但想保留缩进段落，加
--from=plain参数 - 加
--standalone生成含和 CSS 的完整页面，不加则只输出片段 - 注意：
pandoc对中文路径偶尔报错，建议 cd 进文件所在目录再运行命令
浏览器直接打开 txt 时自动渲染成 HTML？不行
有人试过把 .txt 文件后缀改成 .html 就双击打开，发现样式错乱、中文变方块、链接不生效——这不是转换，只是欺骗浏览器用 HTML 解析器读纯文本。
本质问题：浏览器看到 .html 后缀，就按 HTML 规则解析内容，但 txt 里没有 <title></title>、没声明编码、没闭合标签，结果就是 DOM 解析失败 + 渲染异常。
- 典型错误现象：
符号大量出现（编码未声明）、<user></user>被当成自定义标签吃掉、CSS 完全无效 - 临时预览可以右键“查看页面源代码”，确认是否真有
结构和<meta charset="utf-8"> - 哪怕只加一行
<meta charset="utf-8">，也必须放在里，单独扔在开头会被忽略
Node.js 用 fs.readFile() + he.escape() 更轻量
项目里已有 Node 环境，又不想装 Python 或 pandoc，用 JS 也能干净转换。关键不是“能不能”，而是选对转义库——he 比原生 textContent 方案更可控。
性能影响：小文件（
- 安装：
npm install he - 读取后对全文调用
he.escape(text, {useNamedReferences: true})，它比encodeURIComponent更准，支持中文标点实体化 - 别用
DOMPurify或sanitize-html——它们是防 XSS 的，会删掉你想要的<br>和换行 - 写入时用
fs.writeFileSync('out.html', htmlString, 'utf8')，第三个参数必须显式写'utf8'，否则 Windows 下可能存成 GBK
事情说清了就结束。最常被跳过的其实是编码声明和特殊字符转义——其他步骤都好补，这两处错了，浏览器就直接给你摆烂。
