MarkSnip - Markdown Web Clipper

用于下载 Markdown 格式文章的网络剪辑器。 Turndown 和 Readability 被用作核心库。

源代码：https://github.com/DhruvParikh1/markdownload-extension-updated

# MarkSnip - Markdown 网页剪辑器

MarkSnip 是一款功能强大的浏览器扩展，可帮助您以干净、格式化的 Markdown 格式保存网页内容。 MarkSnip 源自出色的 [MarkDownload](https://github.com/deathau/markdownload/) 扩展，现已更新至 Manifest V3，以符合 Chrome 扩展商店要求，同时添加了增强功能，例如改进的表格格式、更清晰的代码块和更好的整体可读性。

＃＃ 特征

- 使用 Mozilla 的 Readability.js 进行干净的文章提取
- 使用 Turndown 准确地将 HTML 转换为 Markdown
- 打印精美的表格，具有可定制的格式
- 通过语言检测增强代码块处理
- 图片下载和管理
- 黑曜石整合
- 丰富的上下文菜单选项
- 可定制的正面/背面模板
- 深色模式支持

## 对于开发者

作为开发人员，文档对于您的工作流程至关重要。 MarkSnip 简化了保存技术文档以供大型语言模型 (LLM) 和其他开发工具使用的过程：

- **一键文档导出**：无需手动复制 API 文档、代码示例和说明的各个部分，只需单击一下即可捕获整个文档页面 - 完成正确的代码块格式设置和语法突出显示。

- **LLM 就绪格式**：干净的 Markdown 输出非常适合输入 LLM 以提供代码帮助，从而在编码时更轻松地使用 AI 工具。

- **代码块保留**：所有代码片段都会自动检测并保留在带有适当语言标签的围栏代码块中，保持语法突出显示和格式设置。

- **批处理**：研究多种技术时，使用“下载所有选项卡”功能将整个文档集快速保存为单独的 Markdown 文件。

- **表处理**：技术规范和 API 参数表以干净的格式进行转换，使其易于以编程方式引用或处理。

## 用例

### 开发人员
- 保存 API 文档以供离线参考或 LLM 帮助
- 使用正确的语法突出显示捕获代码片段
- 建立个人技术解决方案知识库
- 存档 GitHub 自述文件和文档
- 保存 Stack Overflow 解决方案并保持格式不变

### 研究人员
- 收集学术文章和论文以供引用
- 用表格和图形保存方法论部分
- 以正确的格式存档研究数据
- 创建文献综述集
- 导出会议记录

### 作家和内容创作者
- 保存具有适当归属的参考资料
- 捕获风格指南和品牌文档
- 归档已发表的作品集文章
- 用图像保存灵感片段
- 从多个来源创建内容简介

＃＃＃ 学生
- 保存讲义和课程材料
- 从在线资源创建学习指南
- 存档教育文章和论文
- 保存编程教程中的代码示例
- 收集作业参考资料

### 知识工作者
- 建立个人知识管理系统
- 保存会议记录和文档
- 从多个来源创建项目维基
- 存档重要的电子邮件和通讯
- 保存流程文档和工作流程

### 数据分析师
- 保存数据文档和模式
- 捕获方法描述
- 存档数据可视化说明
- 保存SQL查询和解释
- 从网络资源创建数据字典

### 设计师
- 保存设计系统文档
- 存档 UI/UX 模式和示例
- 用图像收集灵感
- 保存无障碍指南
- 创建组件文档

## 用户指南

1. **基本剪辑**
- 单击浏览器工具栏中的 MarkSnip 图标
- 选择剪切整个页面或选定的文本
- 如果需要，编辑生成的 Markdown
- 单击“下载”保存为 .md 文件

2. **上下文菜单选项**
- 右键单击​​页面上的任意位置可以：
- 将整个页面下载为 Markdown
- 将页面复制为 Markdown
- 下载/复制所选文本为 Markdown
- 将链接和图像复制为 Markdown
- 右键单击​​浏览器选项卡可以：
- 将所有选项卡下载为 Markdown
- 将选项卡链接复制为 Markdown 列表

3. **表格格式选项**
- 从表格中删除链接
- 删除格式（粗体、斜体等）
- 启用漂亮的打印以实现干净的对齐
- 列中的居中文本

4. **图像处理**
- 下载图像和 Markdown 文件
- 在各种图像参考样式之间进行选择
- 在自定义文件夹中组织图像
- 将图像转换为 base64（可选）

## 黑曜石集成

MarkSnip 支持通过高级 URI 插件与 Obsidian 直接集成。要使用此功能：

1. 在 Obsidian 中安装并启用 [Advanced Obsidian URI](https://vinzent03.github.io/obsidian-advanced-uri/) 插件
2. 在 MarkSnip 的选项中配置您的保管库和文件夹设置
3. 使用“复制到 Obsidian”上下文菜单选项或键盘快捷键

高级 URI 插件通过使用剪贴板作为创建新文件的源来帮助绕过 URL 字符限制。

## 键盘快捷键

- Alt+Shift+M：打开 MarkSnip 弹出窗口
- Alt+Shift+D：将当前选项卡下载为 Markdown
- Alt+Shift+C：将当前选项卡复制为 Markdown
- Alt+Shift+L：复制当前选项卡 URL 作为 Markdown 链接

## 外部库

MarkSnip 依赖于几个开源库：

- Mozilla 的 [Readability.js](https://github.com/mozilla/readability) 用于内容提取
- [Turndown](https://github.com/mixmark-io/turndown) 用于 HTML 到 Markdown 的转换
- [highlight.js](https://highlightjs.org/) 用于代码语言自动检测。
- [CodeMirror](https://codemirror.net/) 用于 Markdown 编辑器

## 学分

- 由 Deathau 开发的原始 [MarkDownload](https://github.com/deathau/markdownload/) 扩展
- [CommonMark](https://github.com/dcurtis/markdown-mark) 图标，作者：Dustin Curtis
- 所有令人惊叹的开源库及其贡献者

＃＃ 问题

如果您发现问题或有任何反馈，请随时访问 https://github.com/DhruvParikh1/markdownload-extension-updated

＃＃ 执照

MarkSnip 是根据 MIT 许可证授权的开源软件。