一些 Markdown 技巧实践

2025-03-05 {Tech 技术} [markdown]

短横的应用 #

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

1. 连字符(hyphen):-
2. 连接号(en dash):--
3. 破折号(em dash):---
Tip

Hugo 自带 Markdown 解析器 Goldmark 的 typographer 扩展可以自动将这些短横解析:-,–(–),—(—)。

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

换行不换段 #

在书写 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 常用符号:

&copy; (版权符号 ©)
&reg; (注册商标符号 ®)
&trade; (商标符号 ™)
&larr; (左箭头 ←)
&uarr; (上箭头 ↑)
&rarr; (右箭头 →)
&darr; (下箭头 ↓)
&#176; (度 °)
&#960; (圆周率 π)

其他 #

本博客使用 Hugo 生成,还支持 PHP Markdown 的定义列表(definition list)扩展:

Apple
:   A kind of red fruit
Apple
A kind of red fruit

但由于此语法并不通用,我竭力避免使用。