Markdown 官方似乎都没有给出相应的规范。网上也很少有人讨论这些。

Github 使用 Linguist 执行语言检测和语法高亮。我在 Linguist 规范中似乎没有找到答案。于是创建了一个讨论 What is the preferred way to include error messages in Markdown? · Discussion #5927 · github/linguist，期待能得到答案。

与 Linguist 同类的是 highlight.js，但是 highlight.js 上也没有找到用于显示日志、提示、警告、错误等消息的语法高亮。

于是我创建了一些 示例，然后将其放在 GitHub 上，通过对代码块使用不同语言渲染后的效果，我的建议是，使用 markdown 语言标识符仅高亮 Markdown 语法，或者不要添加任何语言标识符，不进行语法高亮显示，因为似乎没有一种语言标识符能满足，杂乱的高亮反而影响阅读。

StackExchange 上也有说用引用，但是引用不会自动换行，它和无语法的文本一样，在 Markdown 中普通换行是不会换行的。没有换行阅读起来更累，因为用引用肯定是不行的。

当然最好的方案就是 Linguist 使用 Jetbrains IDE 使用的语法高亮。你看他们家的 IDE 对输出的信息显示得多好。

静态网站托管平台虽然有很多，如：Gitee Pages、GitHub Pages、Vercel、Netlify、Cloudflare、Coding……，其中只有 Gitee Pages、Coding 是国内的企业，但能免费将 GitHub Organization 中的仓库网站免费托管并支持自定义域名的平台并不多，注意我这里说的是 GitHub 组织，并不是 GitHub 个人仓库。

对于一个入不敷出的开源组织网站，从长远的角度来看，我是不愿意将其付费托管的。

下面我将说下我尝试过的静态网站托管平台及最终使用的是哪个平台。

对于像我这样喜欢收集自己的个人指标的人来说，2021 年是个好年头。早些时候，我聊了收集空气质量数据、Twitter 数据——以及现在的 GitHub 贡献数据。在这篇文章中，我将描述一种简单的方法来获取你自己的 GitHub 贡献统计数据，而不必跳过太多圈套。