Markdown 语法 · 链接
Markdown 怎么加链接？
行内、引用式、相对链接一次讲清
Markdown 里的链接就是两对括号挨着写:文字放 [ ]、链接放 ( ),写成 [文字](链接)。这一行覆盖你大多数需求。
剩下的是知道怎么链到别的文件、某个标题、或复用的 URL——以及哪些小错会悄悄让链接失效。这篇都讲清,带例子。
还没搞懂整体语法?先看 Markdown 怎么写。
五种链接
| 类型 | 写法 | 什么时候用 |
|---|---|---|
| 行内链接 | [文字](链接) | 日常最常用的链接 |
| 带提示文字 | [文字](链接 "提示") | 加悬停提示 |
| 相对 / 本地链接 | [文字](path/to/file.md) | 链到文件夹里的另一篇笔记 |
| 锚点链接 | [文字](#标题) | 跳到同一文档里的某个标题 |
| 引用式链接 | [文字][id] … [id]: 链接 | 复用同一 URL，或把长 URL 移出正文 |
合起来:
行内链接：
看 [文档](https://example.com/docs)。
带提示文字：
看 [文档](https://example.com/docs "阅读文档")。
链到另一篇笔记（相对这个 .md）：
回到 [首页](../index.md)。
跳到本文的某个标题：
跳到 [安装](#setup)。
引用式——定义一次、反复用：
看 [指南][g]，再看 [指南][g]。
[g]: https://example.com/guide链到另一个文件或某个标题
- 另一个文件:用相对路径——
[首页](../index.md)——相对你所在的.md解析。这正是让一个文件夹里的笔记互相链接的办法。想让路径不乱,看 md 文件怎么整理。 - 某个标题:用锚点——
[安装](#setup)。锚点是标题转小写、空格换连字符。适合长笔记里做目录。
引用式链接,让正文更干净
一段里长 URL 一多,行内链接就难读。引用式把 URL 拿出来:在要放链接的地方写 [文字][id],再在文档任意处定义 [id]: 链接。同一个 [id] 想用几次用几次——改 URL 只改一处。
Markdown 链接为什么不生效
| 症状 | 怎么回事 | 怎么修 |
|---|---|---|
| 链接显示成纯文字 | ] 和 ( 之间有空格 | 紧挨着写：] ( → ]( |
| 本地链接跳不过去 | 相对路径起点写错 | 它相对 .md 文件——从那儿数文件夹 |
| 外链断了 | 漏了协议头（没 https://） | 写完整 URL：https://example.com |
| 锚点跳不过去 | #锚点和标题 slug 对不上 | 标题转小写、空格换连字符；再查你的渲染器 |
头号原因:] 和 ( 之间有空格。Markdown 要它们紧挨着——[文字](链接),绝不是 [文字] (链接)。
用 NoteLoom 写链接
NoteLoom 是个在浏览器里读写本地 .md 文件的编辑器。你在 source 或 live 视图里写和改 [文字](链接),reading 视图把它们显示成可点的链接——都直接存回你本地的文件。
先说清边界:NoteLoom 没有任何 AI——不会替你找 URL、写锚文本、查链接死活。它只打开、显示、存回你的 Markdown;链接是你自己写的。
用起来:用 Chrome / Edge / Arc 打开 app.noteloom.cc → 挂载一个本地文件夹 → 打开 .md → 在 source 里写链接 → 存回本地,不上云、不用账号。
FAQ
Markdown 里怎么加链接？
把要显示的文字放方括号、链接放圆括号，紧挨着写：[文字](链接)。收尾方括号和开头圆括号之间别有空格——那个空格是链接失效最常见的原因。
怎么链到另一个 Markdown 文件？
在圆括号里用相对路径：[文字](path/to/file.md)，相对你正在写的这个 .md 解析。另一篇在同一文件夹就是 [文字](other.md)，上一层就是 [文字](../other.md)。
怎么链到本文里的某个标题？
用锚点：[文字](#标题)。锚点一般是标题文字转小写、空格换成连字符——"## Getting Started" 就是 [文字](#getting-started)。具体规则各渲染器不同，不跳就查一下你用的那个。
什么是引用式链接？
不把 URL 写在行内，而是给它一个短 id——[文字][id]——再在别处定义一次 [id]: https://example.com。它把长 URL 从正文里拿出来，还能用 id 反复引用同一个链接。适合链接很多的写作。
我的 Markdown 链接为什么不生效？
通常是：] 和 ( 之间有空格；相对路径起点写错了（它相对 .md 文件）；或外链漏了协议头（写 https://example.com，不是光 example.com）。先查这三样。
NoteLoom 能帮我写链接吗？
NoteLoom 打开你本地的 .md，让你在 source 或 live 视图里写和改 [文字](链接) 链接，再存回本地。它没有任何 AI——不会替你找 URL、写链接文字；链接你自己写，它只负责显示和存回你的 Markdown。
手机或 Safari 能用 NoteLoom 弄吗？
目前不行。NoteLoom 依赖浏览器的 File System Access API，当前支持 Chrome、Edge、Arc 这类 Chromium 系桌面浏览器；Firefox、Safari 和手机端暂不支持。
链接,写好、点着看,都在一处
用 Chrome / Edge / Arc 打开 NoteLoom,挂载一个本地文件夹,在 source 视图里写 [文字](链接)——reading 视图显示成可点链接,都存回本地。不用装软件,也不用注册账号。