前置知识: Markdown

Emoji表情

5 minBeginner2026/6/14

Markdown中Emoji的使用方式:短代码语法、Unicode字符与平台兼容性。

1. Emoji 概述

1.1 在 Markdown 中使用 Emoji

Markdown 支持两种方式插入 Emoji:

方式语法示例适用平台
短代码:emoji_name::smile:GitHub/GitLab
Unicode直接输入通用

1.2 Emoji 的价值

  • 增强表达力:用形补充文字信息
  • 视觉标记:快速识别内容型( 警告、 完成)
  • 提升可读性:在列表和标题中作为视觉锚点
  • 情感传达:在协作讨论中表达语气

2. 短代码语法

2.1 基本用法

今天天气真好 :sunny: :smile:

:tada: 项目发布成功!

:warning: 注意:此 API 已废弃

2.2 常用 Emoji 短代码

表情与手势

短代码渲染短代码渲染
:smile::laughing:
:heart::thumbsup:
:rocket::fire:
:eyes::thinking:
:clap::pray:

状态与标记

短代码渲染用途
:white_check_mark:完成/通过
:x:失败/错误
:warning:警告
:bulb:提示/想法
:bookmark:标记/书签
:construction:建设中

技术相关

短代码渲染用途
:bug:Bug
:sparkles:新功能
:wrench:配置/修复
:memo:文档
:lock:安全
:gear:设置

3. 在 Git 提交中使用 Emoji

3.1 Gitmoji 规范

Gitmoji 是使用 Emoji 标识提交型的约定:

Emoji短代码提交
:tada:初始提交
:sparkles:新功能
:bug:修复 Bug
:memo:文档更新
:lipstick:UI/样式更新
:recycle:代码重构
:zap:性能优化
:lock:安全修复
:arrow_up:依赖升级
:arrow_down:依赖降级
:construction_worker:CI/CD
:white_check_mark:测试

3.2 提交消息格式

git commit -m " feat: add user authentication"
git commit -m " fix: resolve login redirect loop"
git commit -m " docs: update API reference"
git commit -m " refactor: extract validation logic"

4. Unicode Emoji

4.1 直接输入

在支持 Unicode 的编辑器中可以直接输入 Emoji 字符:

今天天气真好

项目发布成功!

注意:此 API 已废弃

4.2 Unicode 编码

每个 Emoji 都有对应的 Unicode 码点:

EmojiUnicodeHTML 实体
U+1F604😄
U+2764❤
U+1F680🚀
U+2705✅

4.3 组合 Emoji

某些 Emoji 可以通过零宽连接符(ZWJ, U+200D)组合:

 + ZWJ +  =  (女程序员)
 + ZWJ +  =  (男农民)

5. 平台兼容性

5.1 短代码支持

平台短代码支持说明
GitHub完整支持
GitLab完整支持
Obsidian完整支持
Typora完整支持
Hugo需配置
CommonMark不支持短代码

5.2 渲染差异

不同操作系统对 Emoji 的渲染风格不同:

系统风格示例
macOS/iOSApple 风格圆润、色彩丰富
WindowsMicrosoft 风格扁平、轮廓清晰
AndroidGoogle 风格简约、色彩鲜明
Linux取决于字体可能显示为黑白

6. 最佳实践

6.1 适度使用

  • 在标题和列表中使用少量 Emoji 增强可读性
  • 在 Git 提交消息中使用标准 Emoji
  • 不要在正式文档中过度使用 Emoji
  • 不要用 Emoji 替代必要的文字说明

6.2 可访问性

  • Emoji 对屏幕阅读器不友好,确保有文字替代
  • 不要仅靠 Emoji 传达关键信息
  • 在正式文档中优先使用文字 + 格式