链接与图片
链接是文档的血管。没有链接,一份文档只是一堆并列的说明;有了链接,读者才能在「结论」和「依据」之间自由跳转,在「使用方法」和「实现原理」之间来回对照。Markdown 给了三种写法链接的方式,它们之间的分工不是「语法难度的递进」,而是信息结构的不同:行内式把文字和地址写在一起,适合地址本身不重要的情况;引用式把地址统一收到文末,适合同一个地址反复出现的情况;自动链接适合你只想贴一个地址、让读者自己看的情况。
三种写法背后是同一个维护成本的考量。同一篇文章里重复出现十次的地址,如果分散写在正文里,改一次域名就要动十处,还容易漏;而收进文末的一条定义,改一次只需要改一行。引用式链接解决的不是「写起来更快」,而是「改起来更省心」——文档写得越久、引用得越多,这个差距越明显。
贯穿这一章的一个判断是:显示文字和实际地址要不要分开。显示文字是给人看的,地址是给机器用的。地址里带着查询参数、追踪 ID 或者一长串编码时,把它们分开写,读者才看得懂你链接的是什么;反过来,当地址本身就是要传达的信息——一个下载链接、一个接口地址、一个邮箱——把它原样露出来反而更方便。
图片是这一章的另一半。它的语法和链接几乎一样,只是多了一个感叹号,但多出来的那个替代文本承担了完全不同的职责:它是图片在加载失败、被读屏软件朗读、被复制到别处时的替身。写好替代文本,比把图片尺寸调准更重要。
这一章有一个在中文文档里特别容易踩的坑: 当地址后面紧跟中文时,自动链接会把中文一起吞进地址里——因为 GFM 的「排除尾部标点」名单只覆盖英文标点,中文句号和中文字符都不在内。写完地址顺手检查一下后面跟的是什么,能省掉很多「为什么这个链接点不对」的困惑。
