一些 Markdown 技巧实践

pub: 2025-03-05 | mod: 2025-06-05 { Tech 技术 } [ markdown ]

短横的应用

这玩意也是个麻烦的东西，首先在英文中按定义有三种短横，由于直接输入比较麻烦，就定义分别由 0 和 = 中间的 - 一二三条组成（请注意这三种短横原本都是一条线并非拼接而成）：

1. 连字符（hyphen）：-
2. 连接号（en dash）：--
3. 破折号（em dash）：---

TIP

Hugo 自带 Markdown 解析器 Goldmark 的 typographer 扩展可以自动将这些短横解析：-，—（–），---（—）。 已使用 Astro 重构博客，目前只使用前两种。

使用方法就不赘述了，可以看这篇文章讲解，或者看知乎回答。

在书写 Markdown 时如果仅仅回车，那么解析出来的文字将仍会是同一段落：

输入：

这是第一段。
这里换行了吗？

输出：

这是第一段。这里换行了吗？

要想换行不换段，显示表达且兼容性更高的做法应该是用 HTML 元素 <br>（如果想要大段空行这仍是好方法）；但是我为了尽量减少 md 文件中 HTML 表达，选择在行末添加两个空格，大部分 Markdown 的解析器都能识别此表达，以下示例：

输入：

这是第一段。  //有两个空格结尾
这里换行了吗？

输出：

这是第一段。这里换行了吗？

通常都使用外链图床或者静态资源加载图片，但如果想要一个 md 文件完成，可以采用曲线救国办法---图片转为 base64。

![picname][foobar]
# 放在文章末尾
[foobar]:data:image/png;base64,iVBORw0......


# 或者直接使用 html 的 tag
<img src="data:image/png;base64,iVBORw0......"\>

HTML 常用符号：