我想写一个编码标准规格文件的好的和坏的编码例子。每条规则都应该有一个数字、一个描述和一个示例。
例如,下面是规则1:
# Rule 1
Description for rule 1.
## Good
```cint foo (无效)
{
int i;}
## Bad
```cint foo (void) {
int i;}
从每条规则中,我希望生成一个PDF或HTML页面,其中包含一个全局目录。
如何编写与标记兼容的代码,该代码可以表示具有语法着色的水平对齐代码块?
就像这样(这是一张图片):

我知道我可以在我的Markdown文档中使用HTML,所以我可能能够编写这样的东西:
<good>
```cint foo (无效)
{
int i;}
</good>
<bad>
```cint foo (void) {
int i;}
</bad>然后再处理数据(我还是不知道怎么处理)
markdown -> own-tags-processing -> LaTeX -> pdf
markdown -> own-tags-processing -> HTML 是否有更好的方法水平地对两块代码?
发布于 2015-05-29 02:52:24
您不能,至少不能使用纯Markdown,因为它没有任何列的概念。正如规则中所解释的那样
Markdown的想法是使读、写和编辑散文变得容易。HTML是一种发布格式;Markdown是一种书写格式。因此,Markdown的格式语法只解决了可以用纯文本表达的问题。 对于未被Markdown语法覆盖的任何标记,只需使用HTML本身。
实际上,最好的方法是将每个代码块包装在一个<div>中,并为每个div分配适当的类。但是,大多数Markdown解析器并不在原始HTML块中解析Markdown。因此,您可能还需要在原始HTML中定义代码块。检查解析器的特性列表以找出答案。如果您无法定义您自己的CSS以单独使用Markdown (为HTML设置样式),您还需要在HTML中内联定义样式。这个问题包含了一个很好的示例,展示了它的样子。只需用适当的代码块替换注释即可。如果您必须用原始HTML定义代码块,它们将如下所示:
<pre><code class="language-c">int foo (void)
{
int i;
}
</code></pre>所以,最后的文件,肯定会在所有(大多数?)减价解析器将如下所示:
# Rule 1
Description for rule 1.
<div style="-webkit-column-count: 2; -moz-column-count: 2; column-count: 2; -webkit-column-rule: 1px dotted #e0e0e0; -moz-column-rule: 1px dotted #e0e0e0; column-rule: 1px dotted #e0e0e0;">
<div style="display: inline-block;">
<h2>Good</h2>
<pre><code class="language-c">int foo (void)
{
int i;
}
</code></pre>
</div>
<div style="display: inline-block;">
<h2>Bad</h2>
<pre><code class="language-c">int foo (void) {
int i;
}
</code></pre>
</div>
</div>请注意,这使用了在CSS中定义列的多种不同方法之一。不同的方法可能在不同的浏览器中工作,也可能不起作用。YMMV
发布于 2020-01-22 04:08:08
虽然这并不适用于所有的标记,但我将其用于GitLab、Github和mdBook。我想我可以分享这个答案。
基本上,您可以通过HTML创建表。标记和HTML并不是很好的混合,但是如果你用空格包围减价,有时可以识别减价。
https://docs.gitlab.com/ee/user/markdown.html#inline-html
<table>
<tr>
<th> Good </th>
<th> Bad </th>
</tr>
<tr>
<td>
```c++int foo() {
int result = 4;return result;}
</td>
<td>
```c++int foo() {
int x = 4;return x;}
</td>
</tr>
</table>发布于 2019-01-13 01:17:26
这是一个老生常谈的问题,但如果人们从谷歌来到这里,上面的答案对于简单的真标记是正确的,但是如果您希望使用或通过实现克拉姆顿的方法来实现这个问题,kramdown确实支持混合的PHP标记额外和Markdown语法,就像kramdown docs 这里中提到的那样。kramdown只是要求在您打算使用上述HTML的标记页面中,向markdown="1"的包装HTML元素添加一个属性。
作为一个例子(以及两列标记的直接解决方案),这将导致内容的两列。我使用Bootstrap来处理列宽和图像对中,但是您可以对这些主题采取任何方法。
<div class="row">
<div class="col-md-8" markdown="1">
Some text.
</div>
<div class="col-md-4" markdown="1">
<!--  -->
<img height="600px" class="center-block" src="../img/folder/blah.jpg">
</div>
</div>小心凹痕。我在上面的代码中没有缩进一个以上的级别。我相信默认情况下kramdown会将双缩进代码解释为一个引号块(如果我没记错的话,这通常是Markdown的标准)。
还请注意,我选择使用html img标记而不是标记图像链接。你可以选择这样做,因为你获得了一些额外的控制。
而且,如果您是新手或不熟悉引导,您可以通过更改上面代码中所示的8和/或4来更改相对列宽度,只需确保这两个数字的之和始终为12。
如前所述,这只适用于实现kramdown引擎的降价消费者(这对Jekyll用户来说非常好)。
https://stackoverflow.com/questions/30514408
复制相似问题