内容
# 下跌
一个markdown网页浏览器。 将任何网页转换为干净的markdown并在无干扰的阅读器中浏览网页。 编辑时实时预览,打开本地文件和文件夹,管理书签和历史记录。
还可用作AI代理的MCP服务器,浏览器扩展和独立的HTTP API。
[GitHub](https://github.com/Nuvotion-Visuals/Downturn) | [npm](https://www.npmjs.com/package/downturn)
<img width="1181" height="998" alt="Screenshot_20260414_012630" src="https://github.com/user-attachments/assets/0ed28494-f59b-4166-a540-32ed20fef86f" />
## 网页浏览器
```bash
npm run dev
```
打开 `http://localhost:4001`。 输入网址,搜索词或域名,然后按Enter。
- **以markdown浏览网页** — 点击链接导航,Ctrl+点击在新标签中打开
- **标签页** — 拖动重新排序,中键点击关闭,Ctrl+T/W创建/关闭
- **分屏视图** — markdown编辑器 + 渲染预览,或切换到单个面板
- **编辑** — markdown面板始终可编辑,实时预览
- **脚注** — 标准 `[^1]` 参考文献,`[^1]:` 定义渲染为链接的脚注部分;点击参考文献跳转到引用,点击↩返回
- **本地文件和文件夹** — 打开单个 `.md` 文件或整个文件夹,带有文件树侧边栏。 在文件夹内,相对和仓库根绝对图像路径(例如 `/media/pic.png`)解析为文件夹根,`.md` 文件之间的链接在原位打开(Ctrl/中键点击在新标签中打开)
- **保存** — Ctrl+S 保存到打开的文件,或触发另存为
- **书签** — 星形图标书签当前页面,在侧边栏中可见
- **历史记录** — 自动,可搜索,按日期在侧边栏中分组
- **自动补全** — URL栏在输入时从历史记录和书签建议
- **搜索** — 普通文本搜索网页;结果渲染为markdown
- **YouTube** — 粘贴YouTube网址获取视频转录为markdown,可选时间戳
- **GitHub** — 粘贴GitHub仓库网址查看README
- **站点导航** — 侧边栏从页面提取导航链接,带有站点首页链接
- **主题** — 黑色,浅色和黑色(OLED)。 自动检测系统偏好
- **字体排版** — 选择编辑器和预览字体,调整字体大小,行高和行宽
- **图标** — 在标签页,书签,历史记录和自动补全中显示
- **PWA** — 可安装为独立应用程序,支持离线
- **移动设备** — 响应式布局,触摸目标,滑动导航和侧边栏叠加
- **禅模式** — 隐藏所有UI界面,专注于内容
## 浏览器扩展
适用于Chrome和Firefox。 一键将当前页面转换为markdown — 无需服务器。 编辑结果,复制到剪贴板,或下载为 `.md`。
构建:
```bash
npm run ext:build
```
在Chrome中从 `extension/dist/` 加载解压的扩展(`chrome://extensions`),或在Firefox中作为临时插件加载(`about:debugging`)。
## 部署
```bash
npx wrangler deploy
```
通过GitHub Actions在版本号增加时自动部署到Cloudflare Workers。 还发布到npm并创建包含浏览器扩展包的GitHub发布。
## MCP服务器
```json
{
"mcpServers": {
"downturn": {
"command": "npx",
"args": ["-y", "downturn"]
}
}
}
```
工具:
- **`url_to_markdown`** — 获取网址并返回markdown。 GitHub仓库返回README。 YouTube视频返回转录。
- **`html_to_markdown`** — 将HTML字符串转换为markdown
| 参数 | 默认值 | 描述 |
|-----------|---------|-------------|
| `output_path` | | 写入markdown的完整文件路径 |
| `output_dir` | | 写入目录;文件名从页面标题自动生成 |
| `include_title` | `true` | 添加页面标题为H1 |
| `include_links` | `true` | 包含超链接 |
| `include_images` | `true` | 包含图像 |
| `use_readability` | `true` | 提取文章内容 |
| `absolute_urls` | `true` | 将相对URL解析为绝对URL |
## HTTP API
```bash
PORT=3000 node index.mjs
```
```
GET /?url=https://example.com&title=true&links=true&clean=true
POST / with html= and url= parameters
```
返回 `Content-Type: text/markdown`,带有CORS头部。
## 流水线
1. 获取页面(跟随重定向)
2. 删除脚本和样式
3. 提取文章内容(Mozilla Readability)
4. 转换为markdown(Turndown)
5. 将相对URL解析为绝对URL
6. 删除空的永久链接锚点和链接标题
7. 编码URL中的括号
8. 应用特定于站点的过滤器(Wikipedia,Medium,Stack Overflow等)
## 测试
```bash
npm test
```
618个测试覆盖转换流水线,URL解析,链接标题删除,永久链接锚点删除,markdown渲染,工作器API,MCP集成,导航提取,标题提取, omnibox,图标和防抖。 测试在部署前在CI中自动运行。
## 结构
```
worker.mjs Cloudflare Worker + 本地开发服务器
index.mjs HTTP API服务器
mcp.mjs MCP stdio传输
wrangler.toml Cloudflare部署配置
url_to_markdown_processor.mjs 核心转换流水线
url_to_markdown_common_filters.mjs 后处理过滤器
url_to_markdown_formatters.mjs 代码块和表格预处理
url_to_markdown_readers.mjs URL获取,跟随重定向
url_to_markdown_apple_dev_docs.mjs Apple开发者文档解析器
html_table_to_markdown.mjs HTML表格转换
title_utils.mjs 标题提取和文件名 slugification
public/
index.html 网页UI
ui.mjs markdown渲染器,omnibox,实用工具
db.mjs IndexedDB存储(设置,历史记录,书签,缓存)
themes.mjs 主题系统(黑暗,浅色,黑色)
sw.js PWA/离线服务工作器
start.md 开始页面内容
site.webmanifest PWA清单
extension/
manifest.json 浏览器扩展清单(Chrome + Firefox)
src/ 扩展源文件
build.mjs esbuild打包器
dist/ 构建的扩展(gitignored)
lib/
html_parser.mjs DOM解析器(vendored JSDOMParser)
readability.mjs 内容提取(vendored Readability)
turndown.mjs HTML到markdown(vendored Turndown)
html_entities.mjs HTML实体解码器
http_server.mjs 节点上的HTTP服务器:http
rate_limiter.mjs 滑动窗口限流器
```
## 鸣谢
- [Mozilla Readability](https://github.com/mozilla/readability) (Apache 2.0)
- [JSDOMParser](https://github.com/mozilla/readability/blob/main/JSDOMParser.js) (MPL 2.0)
- [Turndown](https://github.com/mixmark-io/turndown) (MIT)
## 许可证
MIT
MCP 配置
以下是此 MCP Server 的配置信息,可直接复制到 Cursor 或其他 MCP 客户端中使用。
mcp.json
连接信息
猜你喜欢
rea
用于编码代理的逆向工程:一个 CLI 和 MCP 服务器,用于检查任何应用程序,了解其功能,并按照您的方式构建它们。
everything-claude-code
完整的 Claude Code 配置集合 - agents、skills、hooks、commands、rules、MCPs。来自 Anthropic...
MarkItDown MCP
MarkItDown-MCP是一个轻量级服务器,用于将URI转换为Markdown。
cc-switch
跨平台的Claude Code、Codex和Gemini CLI一体化助手。
Agent-Reach
赋予你的AI Agent观察整个互联网的眼睛。读取并搜索...
servers
# 模型上下文协议服务器