530 字
3 分钟
页面浏览--访问次数--
Markdown 缩写词悬浮

先在本页声明一份术语表(定义行本身不会输出到正文),正文里出现的词条会自动变成带原生气泡提示的缩写词。

效果:把鼠标移到下面这些词上(移动端轻触)——采用 SSR 可以大幅优化站点的 LCP 表现,并在 AST 解析阶段完成静态转换;静态资源再交给 CDN 分发。

源码

*[SSR]: 服务端渲染技术
*[LCP]: 最大内容绘制时间指标
*[AST]: 抽象语法树
*[CDN]: 内容分发网络
采用 SSR 可以大幅优化站点的 LCP 表现,并在 AST 解析阶段完成静态转换。

写法要点#

项规则
定义行格式*[缩写]: 释义
符号细节1 个星号、方括号紧贴、方括号后跟 1 个半角冒号、冒号后 1 个空格
声明位置任意位置都可以,官方建议放在文末或章节开头
生效范围仅当前文章,同一篇文章里所有匹配到的词条都会自动转换

边界行为(本仓实测)#

写法实测结果
*[EMPTY]:(释义为空)不生效,定义行原样保留为文本
*[X]:释义(冒号后缺空格)不生效,定义行原样保留为文本
*[DUP]: 第一条 + *[DUP]: 第二条以第一条为准,第二条原样保留为文本
定义了但正文没引用定义行不渲染,正文无变化

实测片段:

*[EMPTY]:
*[X]:释义前无空格
*[OK]: 正常释义
正文里出现 EMPTY、X、OK 三个词。

上面这段里只有 OK 会变成缩写词,EMPTY 与 X 既不变换、那两行定义也会原样显示出来。

服务端渲染技术最大内容绘制时间指标抽象语法树内容分发网络

第 8 篇,共 23 篇本文属于系列

Markdown 缩写词悬浮
https://www.klucen.cn/posts/博客搭建/markdown-abbreviations/
作者
KLucen
发布于
2025-12-14
许可协议
CC BY-NC-SA 4.0

分享文章

生成精美分享图或复制链接,与更多人分享本文。

继续阅读

沿着主题读

基于共同的标签与分类

换条路线

从其他文章中稳定抽取

评论

正在加载评论...

最后更新于 ,距今已过 301 天

部分内容可能已过时