18.3. 最佳实践

通过在markdown里使用 :短名:,可以在渲染出的html里展现emoji图片

依赖模块: pymdownx.emoji

使用步骤:

  1. mkdocs.yml里配置:

    - pymdownx.emoji:
        emoji_generator: !!python/name:pymdownx.emoji.to_png
    

    建议使用to_png,如果使用to_svg会有部分图片因为未付费导致无法显示

  2. 浏览器打开https://www.emojicopy.com/(emojione官方推出的emoji查询网站,虽然并非全部emoji,但也是目前找到的相对最全,并且分类清楚,使用方便的emoji查询网站),将鼠标悬停在图标上方一会,会出现对应的全名,比如

  3. 记录下这个全名,比如这里叫做grinning face

  4. 点击进入附录里的emojione全名短名映射表,在里面查找对应的短名

  5. 在markdown里使用该短名

最省事做法: 直接复制emoji图标

无需mkdocs.yml做任何配置,只要是emoji图标(是图标不是图片),无论是输入法自带的emoji图标,还是https://www.emojicopy.com/上的emoji图标,都可以直接复制粘贴到markdown文档里即可。比如这个笑脸😄就来自我的输入法,可以自行复制到markdown文档里测试。

而且这种方式适用于所有markdown编辑器。