Markdown语言入门 合集 · 第二章 · 基础语法 · 第 10 篇
推荐阅读时间：约 6 分钟
两种语法，覆盖 90% 的引用需求
先看两个人发同一份笔记，差在哪。
- A 的文章里，参考资料那行躺着一长串
https://…，占了整整两行，看着像乱码，没人会去点。 - B 的文章里，那行写的是「这个数据来自哪里」，一点就跳过去了；配图也正好在对那句话的旁边。
内容一模一样，效果差了一整个量级。差别就是这一篇要讲的两种写法。
链接：中括号放文字，小括号放网址
markdown
1 行
[这个数据来自哪里](https://www.baidu.com)
- 中括号里写你想让读者看到的话。
- 小括号里放网址。
一个细节：中括号里的字要说清楚点进去是什么。别写"点击这里"或"详情"，读者不知道会跳到哪，就不敢点。
图片：前面多一个感叹号
图片的写法和链接几乎一样，只在最前面多一个感叹号：
markdown
1 行
中括号里那行字，平时是看不见的。 只有图片加载失败的时候，它才会露出来。
所以它不能随便写。写"image""1"或者干脆空着，图一挂，读者看到的就是一堆没意义的字符；写清楚"第三章的目录截图"，至少他还知道那儿本来有张什么图。
图片地址有三种来源：
- 网络地址：直接贴一个网上的图片链接。
- 本地文件：图片存在自己电脑上，写相对路径（第 16 篇专门讲）。
- 粘贴上传：在编辑器里直接粘贴，它自动帮你存好。不同编辑器支持程度不一样。
四个常见的坑
- 括号用了中文的。 必须用英文的
[]()。中文括号写出来，只会原样显示，不会变成链接。 - 网址本身带括号。 网址里如果有
()，要在网址前后加一对尖括号包起来，或者把括号换成%28、%29。 - 路径里有空格。 空格要写成
%20，最简单的办法是把文件名里的空格去掉。 - 图片被移动或改了名。 图片和文章是绑在一起的，你把图挪到别的文件夹，链接就断了。
它们该摆在哪儿
语法会了，摆哪儿也有讲究。
- 链接：紧跟它要说明的那句话。如果是参考资料，就集中放在文末，别在正文中间插一串。
- 图片：紧贴着它解释的那句话。图离了上下文超过一段，读者就不知道该看图还是看字。
- 别把图全堆在文末。 很多人习惯"先把字写完，最后统一放图"，结果读者读到关键处还得自己往上找——这张图的力气就白费了。
先埋一个钩子
还有一种写法叫引用式链接——把所有的网址集中放在文末，正文里只留一个代号，看起来干净得多。
脚注也是同一类东西：正文里标一个号，文末自动汇总，特别适合放资料来源和补充说明。
这两样，第 14 篇会专门讲。
5 分钟动手
给你的 练习 文件加两样东西：
- 一个链接：指向你最近看过的一篇好文章。
- 一张图：从网上找一张，或者用你电脑里现成的图，用粘贴或上传的方式放进去。
放完看右边，出来了吗？
最后做个总结
链接是「文字 + 网址」，图片在链接前面多一个感叹号；中括号里要写清"点进去是什么"和"图挂了显示什么"。把长网址收进两个字里，文章立刻就干净了。
下篇预告：第11篇：代码块：三个反引号藏着的门道
下一篇讲第二章最后一个符号，也是被误解最深的一个——它不只是给程序员用的。学完这一篇，第二章就收尾了，我会给你一张本章速查表。
「Markdown语言入门」· 第二章 · 第 10 篇 · 完