# 书签大礼包 · Bookmark Collections
将浏览器导出的书签 HTML 一键转换为更易阅读与分享的页面或 Markdown 文档。本仓库包含若干已转换的专题“大礼包”（如：在线工具、在线设计、学习、工作等），以及三种转换脚本，支持目录导航、搜索、响应式布局与 Markdown 导出。
**在线访问：** [https://rockyflux.github.io/Bookmarks/](https://rockyflux.github.io/Bookmarks/)
## 目录结构
- `书签转页面-工具/`
- `bookmark_md.py`：书签 HTML → Markdown (`.md`)
- `bookmark_top.py`：书签 HTML → 带顶部目录的 HTML（简洁版，`_top.html`）
- `bookmark_tree.py`：书签 HTML → 左侧导航 + 搜索的 HTML（增强版，`_tree.html`）
- `在线工具-大礼包/`、`在线设计-大礼包/`、`学习-大礼包/`、`工作-大礼包/`、`文库学术-大礼包/`、`资源探索-大礼包/`、`云盘磁力-大礼包/`、`娱乐休闲-大礼包/`、`软件-大礼包/`、`无知资源书签-大礼包/`
- 每个目录均包含示例：`*.html`、`*_top.html`、`*_tree.html`、`*.md` 以及配图（如有）
## 大礼包内容与价值
这些“大礼包”按主题汇总高质量网站、工具与学习资料，帮助你在不同场景下快速起步、减少检索成本，并以可分享的 HTML/Markdown 形式沉淀到知识库中。
- 在线工具-大礼包：在线实用工具集合（格式转换、下载/上传、图片/音视频处理、PDF、AI 助手等）。
- 价值：临时需求即开即用，免安装，显著提升应急处理与日常效率。
- 在线设计-大礼包：配色、图标、插画、素材、排版、Mockup、UI 组件库与灵感来源。
- 价值：为设计/前端/产品提供快速灵感与落地素材，加速产出。
- 学习-大礼包：MOOC 平台、教程、电子书、题库、编程/数据科学/外语等学习资源索引。
- 价值：构建系统化学习路径，降低入门与进阶的探索成本。
- 工作-大礼包：协同办公、项目管理、效率提升、自动化、远程办公工具与技巧。
- 价值：提升团队与个人生产力，规范流程，减少沟通与重复劳动损耗。
- 文库学术-大礼包：论文检索、期刊索引、学术搜索、文献管理、写作与排版工具。
- 价值：支撑科研与写作场景，提升文献获取、管理与排版质量。
- 资源探索-大礼包：垂直社区、导航站、精选仓库与优质信息源合集。
- 价值：拓展信息半径，降低“找到好资源”的时间成本。
- 云盘磁力-大礼包：常用网盘/资源入口与工具合集（请合法、合规使用，谨慎甄别）。
- 价值：统一入口便于检索与管理，减少分散寻找带来的时间浪费。
- 娱乐休闲-大礼包：音乐、影视、游戏、电子书与兴趣社区入口。
- 价值：适度放松、灵感触发，支持身心可持续的学习/工作节奏。
- 软件-大礼包：软件下载、工具软件、系统工具、开发工具等软件类资源入口。
- 价值：集中常用软件与工具入口，便于查找、对比与快速获取，减少四处搜寻的时间。
- 无知资源书签-大礼包：长期积累的综合性高频书签清单，定期整理归档。
- 价值：覆盖广、密度高，适合作为“万能备用工具箱”。
综合收益：
- 节省时间：免去重复搜索与比对；分类清晰，直达可用资源。
- 降噪与去重：脚本层面的目录/链接去重，提升浏览质量。
- 快速起步：新领域/新任务的“起步工具箱”，降低试错成本。
- 易于分享与沉淀：同时产出 HTML 与 Markdown，便于团队/社区传播与归档。
## 功能特性
- 顶部/侧边导航目录，快速跳转到分类
- 导航搜索与高亮（仅增强版 `_tree.html`）
- 响应式设计、现代化样式、平滑滚动
- 链接与目录去重，避免重复项
- Markdown 导出，便于在 GitHub、知识库中阅读
- 自动复用原始 HTML 的页面标题作为输出标题
## 环境要求
- Python 3.8+
- 依赖：`beautifulsoup4`
安装依赖：
```bash
pip install beautifulsoup4
```
## 快速开始
以下三种脚本均支持“交互式输入路径”的方式运行，输出文件默认与输入文件同目录：
1. HTML → Markdown（`bookmark_md.py`）
```bash
python 书签转页面-工具/bookmark_md.py
# 按提示粘贴书签 HTML 文件的完整路径，例如：C:\Users\Me\Downloads\bookmarks.html
```
输出：`bookmarks.md`
1. HTML → 顶部目录版 HTML（简洁版，`bookmark_top.py`）
```bash
python 书签转页面-工具/bookmark_top.py
# 输出：bookmarks_top.html
```
1. HTML → 左侧导航+搜索版 HTML（增强版，`bookmark_tree.py`）
```bash
python 书签转页面-工具/bookmark_tree.py
# 输出：bookmarks_tree.html
```
## 导入到浏览器（书签）
每个专题目录下的不带后缀的 `大礼包.html`（例如：`在线工具-大礼包.html`、`学习-大礼包.html`）均可直接作为“书签 HTML 文件”导入主流浏览器的书签管理器。
- 建议用于导入的文件：`<目录名>-大礼包.html`（不带 `_top` / `_tree` 后缀）。
- 适用浏览器：Chrome / Edge / Firefox（以及采用相同导入规范的浏览器）。
示例步骤（以 Chrome/Edge 为例）：
1. 打开浏览器 → 书签管理器（Chrome 地址栏输入 `chrome://bookmarks/`）。
1. 选择“导入书签”/“导入书签和设置”。
1. 选中项目中的 `...-大礼包.html` 文件并确认。
1. 导入完成后，书签将按原目录层级出现在你的书签中。
Firefox：菜单 → 书签 → 管理书签 → 导入与备份 → 从 HTML 导入书签 → 选择 `...-大礼包.html`。
## 推荐：使用笔点导入与管理
若你希望在云端更方便地管理、分类与分享这些书签，推荐使用“笔点”（支持主页、模块、分类、书签等丰富能力）。
- 官网：[笔点网址导航](https://www.bidianer.com/)
- 官方导入指南：[导入浏览器书签到笔点主页](https://www.bidianer.com/help/detail/55)
简要步骤（参考官方文档）：
1. 登录笔点 → 点击右上角头像 → 选择“导入书签”。
1. 选择从浏览器导出的书签文件（也可选择本项目中的 `...-大礼包.html`）。
1. 导入成功后可“立即查看”，并根据需要将书签移动到你的分类结构中。
说明：由于笔点的分类模型与浏览器书签树存在差异，导入后建议在笔点内按需整理分类，以获得最佳导航体验。详见官方帮助文档。
## 输出文件命名约定
- 简洁版 HTML：`<原文件名>_top.html`
- 增强版 HTML：`<原文件名>_tree.html`
- Markdown：`<原文件名>.md`
## 示例与预览
在各个“大礼包”目录中可直接打开 `*_top.html` 或 `*_tree.html` 体验效果；`*.md` 文件可在 GitHub 或任意 Markdown 阅读器查看。
## 本地运行
若要在本地以静态站点方式预览首页与各专题，需要 Node.js 环境。在项目根目录执行：
```bash
npx serve
```
启动后终端会显示访问地址（通常为 `http://localhost:3000`），在浏览器中打开即可查看。按 `Ctrl+C` 可停止服务。
## 常见问题
- Q: 导入的书签 HTML 有多级目录吗？
- A: 解析时会智能处理顶层/子分类（不同脚本在目录展现上略有差异），并进行去重。
- Q: 非 UTF-8 的书签文件怎么办？
- A: 请先将文件转换为 UTF-8 编码后再导入。
- Q: 样式是否可定制？
- A: 可在输出的 HTML 中按需调整 `