超链接:方括号 + 圆括号

最常用的链接写法是 [显示文字](网址)——方括号里是读者看到的文字,圆括号里是实际跳转的地址:

更多信息见 [mdview 官网](https://www.mdview.cn/)。

想在新标签页打开、或加提示文字,部分渲染器支持「标题」语法(网址后用引号),但更可靠的做法是依赖渲染器默认行为。

自动链接:直接写网址

有些 Markdown 渲染器会自动把裸网址变成可点击链接,但更保险的写法是用尖括号包起来:

访问 <https://www.mdview.cn/> 或联系 <mdview@ml-smarttech.com>

< > 包裹后,网址和邮箱都会被渲染成可点击的链接,不会因为没加方括号就变成纯文本。

参考式链接:长文档更清爽

当一篇文档里同一个网址要引用很多次,或者网址很长影响阅读时,用「参考式链接」。正文里只写一个简短的标记,把真实地址统一放在文档别处:

详见 [官方文档][docs] 和 [下载页][download]。

[docs]: https://www.mdview.cn/
[download]: https://www.mdview.cn/#download

好处是:正文干净,改网址只要改一处。定义可以放在文档末尾,不影响阅读。

图片:感叹号 + 链接语法

图片语法就是在链接前面加一个感叹号 !![替代文字](图片地址)

![mdview 启动截图](./screenshot.png)

方括号里的「替代文字」很重要:图片加载失败时它会显示出来,屏幕阅读器也会读它,建议总是写一句简短描述。

图片路径:用相对路径引用本地图片(如 ./img/a.png),把图片和 .md 文件放一起,换电脑也不会丢图。mdview 渲染时会按 .md 文件所在目录找相对路径的图片。

把图片做成可点击的链接

想让「点图片跳转到某个网址」(比如点击 logo 跳首页),就把整段图片语法塞进链接的方括号里:

[![mdview logo](./logo.png)](https://www.mdview.cn/)

外层是链接,内层是图片,点图片就跳转。这个小技巧在做导航、示例缩略图时很常用。

文档内锚点跳转(很实用)

每个标题在渲染后会自动生成一个 id(通常是标题文字转小写、空格变连字符)。用 [文字](#id) 就能在文档内跳转,做「返回顶部」「跳到某章节」特别方便:

## 安装步骤

(正文……)

[回到安装步骤](#安装步骤)

注意:锚点 id 的生成规则各渲染器略有差异(中文标题的处理尤其不同)。mdview 在 v1.0.79 修过文档内锚点链接无法跳转的问题,如果你发现锚点点了没反应,先确认 id 是否对得上。不确定时,用英文 id 最稳妥(手写一个 <a id="install"></a> 锚点再链接)。

链接本地文件

链接也可以指向本仓库里的其他 .md 文件或目录,用相对路径:

继续阅读 [表格指南](./markdown-tables.md)。

在 GitHub 等平台点击会跳到对应文件;用 mdview 打开时,相对路径也会按当前文件位置解析。

速查小结

需求怎么写
超链接[文字](网址)
自动链接<网址>
参考式[文字][id] + [id]: 网址
图片![替代文字](图片)
可点击图片[![alt](图)](网址)
文档内跳转[文字](#锚点id)

一句话:链接是方括号配圆括号,图片就是前面加个感叹号,长文档用参考式、做目录用锚点跳转。