链接与图片

链接是文档的血管。没有链接,一份文档只是一堆并列的说明;有了链接,读者才能在「结论」和「依据」之间自由跳转,在「使用方法」和「实现原理」之间来回对照。Markdown 给了三种写法链接的方式,它们之间的分工不是「语法难度的递进」,而是信息结构的不同:行内式把文字和地址写在一起,适合地址本身不重要的情况;引用式把地址统一收到文末,适合同一个地址反复出现的情况;自动链接适合你只想贴一个地址、让读者自己看的情况。

三种写法背后是同一个维护成本的考量。同一篇文章里重复出现十次的地址,如果分散写在正文里,改一次域名就要动十处,还容易漏;而收进文末的一条定义,改一次只需要改一行。引用式链接解决的不是「写起来更快」,而是「改起来更省心」——文档写得越久、引用得越多,这个差距越明显。

贯穿这一章的一个判断是:显示文字和实际地址要不要分开。显示文字是给人看的,地址是给机器用的。地址里带着查询参数、追踪 ID 或者一长串编码时,把它们分开写,读者才看得懂你链接的是什么;反过来,当地址本身就是要传达的信息——一个下载链接、一个接口地址、一个邮箱——把它原样露出来反而更方便。

图片是这一章的另一半。它的语法和链接几乎一样,只是多了一个感叹号,但多出来的那个替代文本承担了完全不同的职责:它是图片在加载失败、被读屏软件朗读、被复制到别处时的替身。写好替代文本,比把图片尺寸调准更重要。

章节

发现内容有问题?

告诉我们哪里需要改进。