提问者:小点点

如何在GitHub Gist中制作样式Markdown的告诫框?


我正在尝试制作一个Markdown的告诫框,例如备注框、GitHub Gist的警告框。我在谷歌上做了一些搜索,我发现Python降价告诫,但这些告诫似乎在GitHub Gist上不起作用。

我已经尝试遵循Python警告告诫,但是这种降价语法在GitHub Gist上不起作用。

!!! Hello Admonition

我也尝试过这样的引导框,但它没有预期的样式:

<div class="alert alert-danger" role="alert">
    <div class="row vertical-align">
        <div class="col-xs-1 text-center">
            <i class="fa fa-exclamation-triangle fa-2x"></i>
        </div>
        <div class="col-xs-11">
                <strong>Error:</strong>                   
        </div>   
    </div> 
</div>

GitHub Gist是否有任何告诫语法或超文本标记语言代码方法?


共3个答案

匿名用户

使用表情符号唤起用户关注

> :warning: **If you are using mobile browser**: Be very careful here!

以下是其他表情符号列表(复制粘贴即可):

https://gist.github.com/roachhd/1f029bd4b50b8a524f3c

或者您也可以使用GitHub markdown:

https://gist.github.com/rxaviers/7360908

匿名用户

您可以使用表格创建一个带有粗体文本的框,如下所示:

| WARNING: be careful to baz the quux before initializing the retro encabulator! |
| --- |

这样呈现:

这有点滥用语法,但它是有效的。不幸的是,正如克里斯指出的那样,没有办法应用其他格式,如颜色。

匿名用户

虽然不完全是一种告诫,但自2022年5月以来,这一点得到了支持(beta测试),正如迭戈·哈兹在讨论16925中所描述的那样

为了更好地突出显示和分离GitHub上留档中的某些信息,我们现在在Markdown文档中呈现一个特殊且可访问的注释或警告块引用。

我们正在使用现有的块引用和粗体文本语法。

第一行必须完全如下所示。
第一个字母区分大小写。第二行可以包含您的内容。

此输入:

> **Note**
> This is a note

> **Warning**
> This is a warning

变成:

警告:语法可能仍在发展,并在讨论中进行辩论。例如,Brenton M. Wiernik评论:

除了其他人提出的语法问题和语义网络问题之外,我还担心这会引入GitHub风格的Markdown和pandoc markdown或Common Mark之间的重大不兼容性。

大量R开发人员在RMarkdown中编写README和其他留档,通常使用pandoc进行处理。

这一变化意味着,当他们的包留档显示在GitHub和其他地方时,用户将无法使用相同的语法获得一致的渲染。

以这种方式重载块引号会在跨标记风格的语法含义上产生不透明的差异,这对于开发人员来说是非常困难的。