标签: github-flavored-markdown

我正在写一些文档markdown,我想记录如何使用bash HEREDOC创建文本文件.这是我要记录的命令:

# cat > /tmp/answers.txt <<EOT
> value1=blah
> value2=something else
> value3=`hostname`
> value4=onetwothree
EOT

在markdown中,使用`将文本呈现为"代码"我试过这样做...

`# cat > /tmp/answers.txt <<EOT`
`> value1=blah`
`> value2=something else`
`> value3=\`hostname\``
`> value4=onetwothree`
`EOT`

......但是这会导致看起来像这样......

# cat > /tmp/answers.txt <<EOT
> value1=blah
> value2=something else
> value3=\

主机名
> value4 = onetwothree
EOT

从 openstreetmap 页面上的共享选项卡，我可以将地图视图导出为 HTML，例如：

<iframe width="425" height="350" frameborder="0" scrolling="no" marginheight="0" marginwidth="0" src="https://www.openstreetmap.org/export/embed.html?bbox=6.047544479370118%2C46.23053702499607%2C6.061706542968751%2C46.23821801159735&amp;layer=mapnik" style="border: 1px solid black"></iframe>
<br/><small><a href="https://www.openstreetmap.org/#map=17/46.23438/6.05463">View Larger Map</a></small>

我想将它嵌入到 github 上的 README.md 页面中，例如

环顾四周，最接近iframe在 markdown 中嵌入s 的是git lab guide。随后我尝试了<figure class="video_container">标签，但在 gitlab 或 github 上都看不到它。

# how to find us?

we will be here:
<figure class="video_container">
<iframe width="425" height="350" frameborder="0" scrolling="no" marginheight="0" marginwidth="0" src="https://www.openstreetmap.org/export/embed.html?bbox=6.047544479370118%2C46.23053702499607%2C6.061706542968751%2C46.23821801159735&amp;layer=mapnik" style="border: 1px solid black"></iframe>
</figure>

我是否遗漏了一些东西，或者这更好地留给真正的 HTML 而不是降价可以/应该做什么？

我有一张桌子:

    | This | Is | A | Table |
    | :--- | -- | - | ----: |
    | foo  | ba | r | elbaT |

我希望表格显示在我的Markdown文件的中心而不是左对齐.我不是要对齐文本,而是整个表本身.我是否需要求助于HTML/CSS来实现我想要的目标？

这是一个Apiary.io项目.

使用GitHub上" Markdown Cheatsheet "中的表格示例,您可以得到:

| Tables        | Are           | Cool  |
| ------------- |:-------------:| -----:|
| col 3 is      | right-aligned | $1600 |
| col 2 is      | centered      |   $12 |
| zebra stripes | are neat      |    $1 |

我的问题是,有没有办法左对齐标题单元格？

这与这篇文章中提出的问题非常相似，但该文章似乎不适用于 GitHub 的解析 Markdown。

简而言之，假设我在 GitHub 存储库中有一个 PDF。有没有什么方法可以将其渲染/嵌入到存储库中的 markdown 文件（例如文件README.md）中？

我也愿意将 PDF 放在 GitHub 以外的位置，并从 Markdown 文件链接到它（如果这是完成这项工作所需的条件）。

我在这里谈论github markdown,对于像这样的文件README.md.

问题: 是否有可能在github上的markdown中删除完整的代码块？

我知道如何将文本标记为代码块

this is
multiline code

and this

this

also

通过缩进4个空格或使用```或`...

我也知道如何使用文本

• del tag
• s标签
• ~~

临时解决方案:

他们独立工作正常,但并不像预期或期望的那样.我尝试了上面提到的几种组合.

现在,我用这个:

striked

through

通过使用~~和`为每一行.

要求:

我希望有一个代码格式化的文本,其中代码块是连续的:

unfortunately, this is
not striked through

或至少在两者之间只有一小段:

unfortunately, also not striked through

这有可能吗？

我发现了一些关于使用jekyll的旧帖子和提示,但我正在寻找的是一种简单的方法,最好是降价.

GitHub 的 Actions 功能最近开始允许用户生成徽章，以展示其测试的状态。例如，如果我有一组测试从名为 的文件在我的存储库的 dev 分支上运行.github/test_dev.yml，我可以通过添加到/badge.svg测试 URL 的末尾来访问该构建的状态。

https://github.com/<username>/<repo_name>/actions/workflows/test_dev.yml/badge.svg

从让您的项目自述文件保持最新的项目状态的角度来看，这非常好，但下一个合乎逻辑的步骤是添加指向最新测试结果的徽章的链接。

不幸的是，即使您可以按如下方式访问特定操作的所有测试：

https://github.com/<username>/<repo_name>/actions/workflows/test_dev.yml

测试运行本身似乎是在一个唯一的ID后面actions/runs/。

https://github.com/<username>/<repo_name>/actions/runs/1234567890

有没有办法构造一个只指向最新测试的 URL？就像是：

https://github.com/<username>/<repo_name>/actions/workflows/test_dev.yml?result=latest

我翻阅了 GitHub 的文档，但尽管有一些关于生成这些徽章 SVG 的文档，但我找不到任何有关直接链接到实际生成该 SVG 的操作的信息。

这给出了关于如何通过markdown解释HTML元素的非常详尽的描述.但它没有讨论风格.

到目前为止,我唯一可以工作的是图像宽度.

1. 我无法在接受/呈现的任何地方找到列表
2. 看起来该style="....."属性完全被忽略.
3. 我甚至无法找到老式的风格属性的列表(相对于该样式属性style=...)

https://gist.github.com/abalter/46df1b79e9f429342972477d7c20cebc

编辑
更改span到div由于div每下@克里斯的回答@ waylan的评论列入白名单的标签之中.

编辑2
看起来firefox和chrome 根本不再呈现任何样式属性.

Markdown有这个很棒的功能,可以在三个反引号(```)之间包含一堆引号来打开包装,另外三个引用它来关闭它.它们之间的内容可以跨越几行,甚至包括空行.一切都会得到保留.

是否有一个等价的报价,不需要我添加>到我想要包装的每一行的前面？

有什么想>>>开始包装报价并>>>再次关闭它？

我正在尝试为Markdown制作一个Markdown提醒框，例如便笺框，警告框。我在Google上进行了一些搜索，发现有Python markdown的警告，但这些警告似乎在GitHub Gist上不起作用。

我已经尝试过遵循Python警告告诫，但是此markdown语法在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是否有任何警告语法或HTML代码方法？