HTML书签导入失败主因是浏览器未识别文件，需检查编码（UTF-8 with BOM）、结构（含DOCTYPE或DL标签）、路径（如/Download目录）及权限（开启存储权限），缺一不可。
HTML书签导入失败，绝大多数情况不是数据丢了，而是浏览器根本没“认出”这个文件——编码、结构、路径、权限四个环节中任意一个卡住，整个流程就停摆。
文件开头没有或
这是 Safari、Chrome、Edge、UC 等主流浏览器识别书签文件的硬性门槛。它们不看文件名，只认结构。
- 用记事本或 VS Code 打开 HTML 文件，滚动到最顶部，必须看到
或至少以或，说明它被当普通网页导出了，不是书签专用格式 - Firefox 导出默认带标准头，Chrome 也是；但某些国产浏览器（如百度、夸克）导出时可能漏掉，需手动补上这行再保存
- 删掉所有
里冗余的、<script></script>、，只留最简书签块：从结束
文件编码不是 UTF-8 with BOM，或浏览器强制按 GBK 解析
百度浏览器、部分旧版安卓浏览器（如米侠、UC）默认用 GBK 读取 HTML，而 Firefox/Chrome 导出的是 UTF-8（无 BOM），一读就乱码，直接跳过解析。
- 在 Notepad++ 或 VS Code 中打开文件 → 右下角点击编码名称 → 选择
UTF-8 with BOM→ 保存 - 不要选 “UTF-8”（无 BOM），百度浏览器对无 BOM 的 UTF-8 兼容极差；也不要选 “ANSI” 或 “GBK”，会导致中文链接变问号
- 可额外在
内插入一行：，作为双重保险
手机端导入时找不到文件或点选无反应
不是文件错了，是浏览器压根没权限读你放的位置，或者系统文件选择器根本没把路径传进去。
Convert Markdown To HTML And PDF - Markdown和HTML、PDF互转
下载
实现 Markdown↔ HTML 互转，支持导出 PDF，用于用户请求的文档格式转换。
- Android 上，Chrome、夸克、UC 要求文件必须放在
/Download或/Documents目录下；放在微信下载目录、QQ 接收目录、内部存储根目录都可能不可见 - 确认手机系统设置 → 应用管理 → 浏览器名称 → 权限 → 已开启“存储”或“文件和媒体”权限
- 米侠浏览器更特殊：它不走常规导入流程，必须把文件重命名为
import.html，放进Android/data/com.mex.browser/files/bookmarks/，且要重启 App 才生效
导入后书签为空、只有一级文件夹、链接全部失效
说明浏览器解析了文件，但中途放弃了——常见于嵌套过深、标签错位、或存在非法字符（比如从网页复制粘贴进来的全角空格、零宽字符）。
- 用浏览器直接打开该 HTML 文件，如果能正常显示完整层级，说明文件本身没问题；如果显示混乱或断开，说明结构已损坏
- 用在线工具如
Bookmark Converter或本地软件Linkman Lite重新导出一次，它会自动清理非法标签、修复缩进、标准化/嵌套 - 特别注意：某些浏览器（如 Edge）导出时会把 URL 编码成
%E4%BD%A0%E5%A5%BD形式，而 Safari 对这类编码支持不稳定，建议用文本编辑器全局替换为原始中文（需确保文件编码一致）
真正麻烦的从来不是“怎么导”，而是“导完谁来验证”。别依赖导入成功弹窗——打开书签管理器，逐层点开，至少展开两级目录，随机点开三四个链接确认能跳转，才算真正落地。中间任何一层塌了，都得回退查结构或换工具重导。
前端入门到VUE实战笔记：立即使用
在学习笔记中，你将探索 前端 的入门与实战技巧！
