在 GitHub Markdown 中使用深色/浅色模式特定的图像
由 Mux 主办的 DEV 全球展示挑战赛:展示你的项目!
嗨,开发者们!👋
希望你的项目进展顺利。
目录
为什么要发这条帖子?🤔
作为开发人员,我们开发项目,整天编写代码,我们可能还会将其发布到GitHub上,以便其他人了解和使用我们的项目。
Markdown 在解释代码、打造项目品牌、展示统计数据等方面发挥着至关重要的作用。
大家都知道现在深色模式有多火,尤其是在开发者群体中。但大多数浏览器默认的模式仍然是浅色模式。
好了,现在来说说这篇文章的重点。GitHub 默认会根据主题自动调整 Markdown 的大部分内容,但默认情况下不会对图片进行任何处理。
想象一下,一张原本设计成在白色背景上看起来很棒的图片,以黑色为前景色。但在深色模式下,它甚至都不会引人注目。
所以,你可能需要根据浏览者浏览器的当前主题优化你的图片。而且,也许还能让图片看起来更酷更专业一些😅。
流程🧪
流程非常简单。我没开玩笑,真的非常简单。
- 请创建两个不同版本的图像,一个针对浅色模式优化,另一个针对深色模式优化。例如,以这张 Termux 的图像为例。我已经创建了同一图像的两个变体,一个用于浅色模式,一个用于深色模式:
浅色模式变体
深色模式变体 - 现在,神奇的事情来了🪄。要使图片仅在深色模式下可见,请
#gh-dark-mode-only在图片网址末尾添加。要使图片仅在浅色模式下可见,请添加#gh-light-mode-only。
例子:


现在,图像的深色模式版本仅在深色模式下可见,浅色模式版本仅在浅色模式下可见。
以上图片链接仅供演示。请将其替换为您自己的图片链接,即可开始使用!
实时示例⚡:
你可以在我的GitHub上看到运行示例。
免责声明⚠️
文章来源:https://dev.to/arnavkr/using-darklight-mode-specific-images-in-github-markdown-3iln请注意,如果图片未托管在 GitHub 上,则不会根据主题进行调整。
