使用方法
- 打开页面就有一组完整结果:示例站点对应 https://example.com、文档对应 https://docs.example.com,结果区已经列出两条 Markdown 链接,不需要先填任何东西。
- 在文本框里按自己习惯的写法录入:一条占一行。最常见的是「标题 空格 网址」,也可以写成「网址 空格 标题」,或者用竖线分隔的「标题 | 网址」。
- 录入后按 Ctrl 或 Cmd 加 Enter,或者直接点「立即转换」,结果会立即在当前浏览器里算出来,不会上传到任何服务器。
- 只想给网址、不给标题时,直接写一行网址即可,页面会自动把域名当成标题,例如 https://example.com 会变成 [example.com](https://example.com)。
- 「复制结果」把转换后的 Markdown 纯文本复制到剪贴板,可直接粘进 README、笔记软件或论坛;「复制对照表」复制下面那张表的制表符文本。
- 网址里如果出现右括号,页面会自动转义成 %29,避免 Markdown 链接提前闭合;这一点在处理带查询参数的链接时尤其重要。
- 本页不联网、不写本地存储,刷新即回到默认示例,适合反复试验不同的写法。
这个URL转Markdown链接工具能解决什么
写文档、写 README、整理资料时,最烦的就是手敲 [标题](地址) 这套括号。网址一长,左右括号数错一位整条链接就废了;一次要列十几条参考链接,纯手工既慢又容易漏。这个URL转Markdown链接工具把这件事拆成一行的录入、一批的转换:你只管把「标题 网址」成排贴进来,它负责把括号配对、把右括号转义、把纯网址补上标题。
第一类场景是「批量列参考资料」。技术文档、论文笔记、周报里经常要塞一排链接,手工写既费眼又容易把链接和标题写反。本工具对每一行独立判断哪一段是网址、哪一段是标题,整批粘贴一次出结果。
第二类场景是「从聊天记录或浏览器收藏里搬运」。这些来源往往只有网址没有标题,或者标题和网址顺序不统一;本工具能自动识别顺序,纯网址行还能反查域名当标题,省去你来回切换窗口去抄页面标题。
解析规则与转义原理
每一行先去掉首尾空白,然后分两种情况。若行内含有竖线「|」,就按竖线切成左右两段,再判断哪一段是以 http(s):// 或 www. 开头的网址:左段是网址就用右段当标题,右段是网址就用左段当标题。若行内没有竖线,就按空白切成若干段,凡是以 http(s):// 或 www. 开头的段被认定为网址,其余段拼起来作为标题。
只有一段且那段像网址时,标题取该网址的域名(去掉前面的 www.);例如 https://example.com 的标题就是 example.com。判断网址的正则固定为「以 http://、https:// 或 www. 开头」,所以带协议的链接和裸 www 域名都能识别,大小写不敏感。
转义是这里最容易踩坑的地方。Markdown 的链接语法里,左括号开始、第一个右括号结束,也就是说 [标题](地址) 在遇到第一个 ) 时就认为链接地址结束。如果网址本身包含右括号,例如 https://example.com/page(v1),不处理就会在 v1 之前截断。本工具把网址里每一个 ) 替换成 %29(右括号的百分号编码),既保住了链接完整,又在浏览器里能正常跳转,因为 %29 解码后还是右括号。
| 情形 | 判定方式 | 说明 |
|---|---|---|
| 标题 网址 | 空白分词后找网址段 | 非网址段拼成标题,最常用写法 |
| 网址 标题 | 同上,顺序无关 | 两段里谁像网址谁就是地址 |
| 标题 | 网址 | 按竖线切分 | 竖线两侧哪段是网址就反过来取标题 |
| 仅网址 | 单段且像网址 | 标题自动取域名,去掉 www. 前缀 |
| 网址含 ) | ) 转义为 %29 | 避免 Markdown 链接在右括号处提前闭合 |
完整示例
默认示例是两条最常见的写法:第一行「标题 网址」,第二行「网址 标题」。它们各自独立解析,结果区第一行用「示例站点」当标题、第二行用「文档」当标题,网址保持原样。下面这张示例同时给出输入与输出,方便你照着改。
输入: 示例站点 https://example.com 文档 https://docs.example.com 输出: [示例站点](https://example.com) [文档](https://docs.example.com)
把第一行改成「https://example.com 示例站点」效果完全一样,因为本工具不关心标题和网址谁在前;把其中一行只留下网址,例如只写 https://example.com,输出会变成 [example.com](https://example.com),标题自动用域名补齐。
输入写法对照表
下表共 14 行,覆盖三种写法、纯网址、含右括号网址,以及一行只有文字没有网址的失败样例。前 12 行默认显示,点工具区的「加载更多」看余下 2 行;每一行的结果都是本页算法当场算出来的,和你在文本框里录入同一行得到的输出逐字一致。
| 输入示例 | 解析方式 | 输出 Markdown |
|---|---|---|
| 示例站点 https://example.com | 标题 空格 网址 | [示例站点](https://example.com) |
| https://docs.example.com 文档 | 网址 空格 标题 | [文档](https://docs.example.com) |
| 博客|https://blog.example.com | 标题 | 网址 | [博客](https://blog.example.com) |
| https://example.com | 仅网址 | [example.com](https://example.com) |
| 带括号 https://example.com/page(v1) | 网址含 ) | [带括号](https://example.com/page(v1%29)) |
| www.example.com 主页 | www 网址 | [主页](https://www.example.com) |
| GitHub|https://github.com/x | 标题 | 网址 | [GitHub](https://github.com/x) |
| 说明 https://a.com/b(c)d | 网址含 ) | [说明](https://a.com/b(c%29d)) |
| 配置 https://x.io/y | 标题 空格 网址 | [配置](https://x.io/y) |
| 工具|https://tool.cn/a | 标题 | 网址 | [工具](https://tool.cn/a) |
| https://note.com 笔记 | 网址 空格 标题 | [笔记](https://note.com) |
| 项目主页 https://proj.example.org | 标题 空格 网址 | [项目主页](https://proj.example.org) |
| 仅网址 https://only.com | 仅网址 | [only.com](https://only.com) |
| 纯文字无网址 | 识别失败 | 第 14 行「纯文字无网址」只含文字、未识别到网址 |
横向看这张表能得出一条结论:只要一行里出现了 http(s):// 或 www. 开头的段,本工具就能稳定产出链接;反之只有纯文字的行会被标注跳过,不会凭空编造一个地址。这样你批量粘贴一整段混合内容时,有用的链接一条不漏,没用的行也被清楚标出。
结果边界与错误提示
- 一行只有纯文字、完全不含 http(s):// 或 www. 开头的段时,本工具不会硬凑,而是输出「第 N 行「内容」只含文字、未识别到网址」,并跳过该行,其余行照常转换。
- 行内用竖线「|」分隔时,若两侧都不是合法网址,同样提示未识别到有效网址(缺少 http(s):// 或 www.),不会把左段当网址误转。
- 网址里出现右括号 ) 会被统一转义为 %29,左括号 ( 保持原样;这样链接地址在 Markdown 里能正确延伸到真正的结尾,不会提前闭合。
- 空白行会被直接忽略,不产生任何输出,也不计入错误行数,方便你粘贴时保留空行分隔段落。
- 网址的大小写不敏感,HTTPS 与 https、WWW 与 www 都能识别;域名后的路径、查询参数、锚点一律原样保留到链接地址里。
- 一行里若同时出现多个像网址的段,本工具只取其中第一个作为地址,其余网址段会被并入标题,避免一条链接塞进两个地址导致失效。
- 标题里若本身含有方括号 [ 或 ],Markdown 仍能正常渲染链接文字,本工具不做额外转义,仅在结果里如实保留,由你决定是否改标题。
- 本页不上传任何输入,也不写本地存储;导出的对照表 CSV 带字节序标记,复制结果为纯文本,粘进表格软件会自动分列。
常见问题
支持哪几种输入写法?
支持「标题 网址」「网址 标题」两种空白分隔写法,以及用竖线分隔的「标题 | 网址」。三种写法顺序和分隔符都灵活,页面会自动判断哪一段是网址、哪一段是标题。
网址里带括号怎么办?
链接地址里的右括号 ) 会被转义成 %29,左括号 ( 保持原样。这样 Markdown 链接不会在第一个右括号处提前闭合,整条地址保持完整,浏览器解码 %29 后仍能正常跳转。
只给网址、不给标题会怎样?
直接写一行网址即可,例如 https://example.com。本工具会取它的域名 example.com 作为标题,输出 [example.com](https://example.com),适合快速把收藏夹里的链接变成可点击文本。
一行能写多个链接吗?
不建议。一行只对应一条 Markdown 链接;若一行里出现多个像网址的段,只取第一个作为地址,其余会被并入标题。多个链接请分行书写,每行一条。
会把我输入的内容上传吗?
不会。所有解析和转义都在你的浏览器本地用 JavaScript 完成,页面不联网、不写本地存储,刷新即回到默认示例,输入内容不会被发送到任何服务器。
标题和网址写反了怎么办?
无需调整。本工具通过「是否以 http(s):// 或 www. 开头」来识别网址,和先后顺序无关,所以「标题 网址」与「网址 标题」两种写法得到完全相同的输出。
支持用换行符一次性粘很多条吗?
支持。文本框按行处理,每一行独立转换,空行自动忽略,有问题的行单独标注。整段粘贴几十上百条链接也能一次出结果。
导出的对照表带字节序标记吗?
带。对照表 CSV 导出时写入 UTF-8 字节序标记,Excel 双击不乱码;「复制对照表」是制表符分隔文本,粘进表格软件会自动分列。
相关工具
- URL编码:把中文与特殊字符编码进网址,避免链接在文档里断行或乱码。
- CSV转JSON转换器:把表格数据在 CSV 与 JSON 之间互转,配合本工具做数据搬运。
- Base64编码:把任意文本编码成可嵌入文本的单行串,适合在 Markdown 代码块里放二进制。
- HTML格式化:把压缩的 HTML 缩进排版,便于先看清页面结构再抽链接。
- JSON格式化工具:把紧凑 JSON 美化输出,和本工具一样都是文档整理辅助。