html-to-markdown

把HTML干净利落地转成Markdown,性能飞快

开源 🏷️完全免费 🔧 仅开源项目,无在线服务,需自行部署 搜索知识 🍴 复刻 76 👀 关注 6
访问官网 ↗ GitHub ↗
GitHub 星标 ★ 888
维护状态 活跃
是否开源 开源
定价模式 🏷️完全免费 开源项目,MIT许可证,完全免费,可自行部署使用。

项目预览

html-to-markdown 项目界面预览图
图片来源:项目官网

项目数据

分类搜索知识
开发团队xberg-io
定价模式🏷️完全免费
价格说明开源项目,MIT许可证,完全免费,可自行部署使用。
访问状态🔧 仅开源项目,无在线服务,需自行部署
是否开源是
开源协议MIT
主要语言HTML
技术栈/模型hocr,html,html-converter,markdown,markdown-converter,rag,text-extraction,text-processing,xberg
GitHub 星标★ 888
上线时间2025-02-03 00:00:00
代码更新2026-11-08
仓库体积183.1 MB
本站数据更新2026-11-09
维护状态活跃
收录时间2026-08-09
浏览次数2

项目介绍

html-to-markdown 是一个高性能且符合 CommonMark 规范的 HTML 转 Markdown 转换器,由 Kreuzberg 团队维护。它解决了将 HTML 内容干净、准确地转换为 Markdown 格式的问题,特别适用于文档处理、内容抓取和 AI 数据预处理等场景。核心能力包括:快速解析 HTML 并生成符合 CommonMark 标准的 Markdown,支持流式处理,能够处理复杂嵌套标签,并保持代码块、表格、链接等元素的正确转换。项目基于 Rust 核心构建,性能优异,同时提供多语言绑定,便于集成到不同技术栈。作为 Kreuzberg 文档智能引擎的一部分,它专注于结构化数据提取,从 98+ 种文档格式中抽取信息,内置 OCR 支持,为文档解析提供坚实基础。目前项目处于早期阶段,但设计目标明确,适合需要高质量 HTML 转换的开发者。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整

数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 888

使用教程

难度:入门 约 12 分钟 部署方式:本地安装 4 步

环境要求

  • 对应语言运行时

安装与启动步骤

  1. 1按语言装

    Python、Node、Rust、Homebrew 四种装法,选你项目用的。

    pip install html-to-markdown
  2. 2命令行转换

    装 CLI 后可直接把 HTML 文件转 md,适合批量处理存量页面。

    cargo install html-to-markdown-cli
  3. 3处理脏 HTML

    它针对真实网页的脏结构做了清理,比通用转换器稳。

  4. 4给 Agent 用

    也可作为 skill 装进编码 Agent,让模型自己转页面。

    npx skills add xberg-io/html-to-markdown

如何确认成功

转换结果保留标题、列表与代码块。

注意事项

  • 复杂表格转换仍会失真,重要数据建议人工核对。

核心亮点

  • 符合CommonMark规范,转换结果标准可靠
  • Rust核心实现,性能远超同类JS/Python库
  • 支持流式处理,适合大规模文档转换

不足之处

  • 项目早期,API和功能可能不稳定
  • 文档和社区生态待观察

适用场景

  • 爬虫抓取网页后转为Markdown供LLM处理
  • 文档管理系统中的HTML导入导出
  • 静态站点生成器内容预处理

替代项目

turndown、pandoc、html2text

上一篇:ChatPDF

下一篇:pg_vectorize

同类项目推荐

awesome-context-engineering 开源

给 AI Agent 配好上下文,让模型少犯错、少烧钱

A curated collection of resources, papers, tools, and best practices for Context Eng···

★ 228 2026-09-15
Deep-Research-Survey 开源

一张地图看懂AI深度研究领域,快速定位技术与产品

A Systematic Survey of Deep Research

★ 323 2026-08-09
devdocs 开源

一个应用查遍所有 API 文档,支持离线,搜索快如闪电

API Documentation Browser

★ 39614 2026-08-15
DataChad 开源

上传数据,直接聊天提问,秒得答案

Ask questions about any data source by leveraging langchains

★ 319 2026-08-09
backstage-plugin-qeta 开源

在 Backstage 里搭建团队问答库,让知识随手可得。

Internal Q&A and knowledge base for Backstage. Empower teams to share knowledge, ask···

★ 116 2026-08-09
DD_Rag 开源

用 SpringAI 打造带权限隔离的企业知识库问答助手

基于 SpringAI 的 Agent 开发项目:一个面向“组织知识库 + AI 助手”的 RAG Agent实战项目···

★ 218 2026-08-09
uajy-academic-rag-chatbot 开源

上传手册就能对话问答,学生查规章秒出答案

Production-grade RAG chatbot for Universitas Atma Jaya Yogyakarta academic handbook ···

★ 453 2026-09-14
leviathan 开源

一条命令把海量记录变成 Agent 可查的全文记忆

Deep memory for agents over large datasets. Leviathan is a single static binary that···

★ 879 2026-10-07