651 字
3 分钟
页面浏览--访问次数--
Markdown 原生表情与图标

原生 Emoji#

效果:Emoji 没有任何特殊标记语法——直接用系统输入法打出来即可,正文、标题、frontmatter 里都能用,渲染时由各操作系统提供彩色字形,不需要额外的转译插件或客户端字典。

🌸 站点装修记录 🎉

  • 主题色换成了粉紫 🎨
  • 侧栏挂上了音乐播放器 🎵
  • 说说的心情图标也换成 Material Symbols 了 😂

源码

🌸 站点装修记录 🎉
- 主题色换成了粉紫 🎨
- 侧栏挂上了音乐播放器 🎵
- 说说的心情图标也换成 Material Symbols 了 😂

本站在动态(说说)的 frontmatter 里也用了 Emoji 之外的图标字段,见下一节。

图标:标识符写法#

效果:图标不写成正文里的 Markdown,而是以「集合前缀:图标名」的标识符形式出现在站点配置、导航栏、侧栏卡片、自定义组件中,构建期被静态提取并内联成 SVG 矢量图。

本站实际用到的位置:

  • 动态的心情图标:mood: material-symbols:headphones-rounded(见动态页里每条说说左上角的图标)
  • 侧栏分类、标签、系列卡片的小图标
  • 导航栏条目的 icon 字段

本站主题可用的图标集合:

集合前缀说明示例标识符
material-symbolsMaterial Symbols(本站主用)material-symbols:apps-rounded
simple-icons各品牌 Logosimple-icons:github
fa6-brandsFont Awesome 品牌图标fa6-brands:github
fa6-solid / fa6-regularFont Awesome 实心/描边图标fa6-solid:house

图标名可以在 Icones 上检索,找到后取其 前缀:名称 即可。

源码(写在配置或 frontmatter 里,不是正文语法)

# 动态的心情图标
mood: material-symbols:music-note-outline-rounded
# 导航栏条目
- name: 系列
url: /series/
icon: material-symbols:auto-stories-outline-rounded

为什么这样设计#

  • 零额外负担:图标在构建期按实际引用提取,不引入整套图标字体包,也不产生运行时请求;
  • 跟随主题:图标以 currentColor 绘制,深浅色模式与主题色切换时自动适配,不需要为暗色模式单独准备一套资源。

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

Markdown 原生表情与图标
https://www.klucen.cn/posts/博客搭建/markdown-emoji-icons/
作者
KLucen
发布于
2025-12-14
许可协议
CC BY-NC-SA 4.0

分享文章

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

继续阅读

沿着主题读

基于共同的标签与分类

换条路线

从其他文章中稳定抽取

评论

正在加载评论...

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

部分内容可能已过时