首页
学习
活动
专区
圈层
工具
发布
社区首页 >问答首页 >在Markdown中有两列

问在Markdown中有两列
EN

Stack Overflow用户
提问于 2015-05-28 18:28:54
回答 6查看 96.2K关注 0票数 68

我想写一个编码标准规格文件的好的和坏的编码例子。每条规则都应该有一个数字、一个描述和一个示例。

例如,下面是规则1:

代码语言:javascript
复制
# Rule 1
Description for rule 1.

## Good
```c

int foo (无效)

{

代码语言:javascript
复制
int i;

}

代码语言:javascript
复制
## Bad
```c

int foo (void) {

代码语言:javascript
复制
int i;

}

代码语言:javascript
复制

从每条规则中,我希望生成一个PDF或HTML页面,其中包含一个全局目录。

如何编写与标记兼容的代码,该代码可以表示具有语法着色的水平对齐代码块?

就像这样(这是一张图片):

​

​

我知道我可以在我的Markdown文档中使用HTML,所以我可能能够编写这样的东西:

代码语言:javascript
复制
<good>
```c

int foo (无效)

{

代码语言:javascript
复制
int i;

}

代码语言:javascript
复制
</good>
<bad>
```c

int foo (void) {

代码语言:javascript
复制
int i;

}

代码语言:javascript
复制
</bad>

然后再处理数据(我还是不知道怎么处理)

代码语言:javascript
复制
markdown -> own-tags-processing -> LaTeX -> pdf
markdown -> own-tags-processing -> HTML 

是否有更好的方法水平地对两块代码?

EN

回答 6

Stack Overflow用户

回答已采纳

发布于 2015-05-29 02:52:24

您不能,至少不能使用纯Markdown,因为它没有任何列的概念。正如规则中所解释的那样

Markdown的想法是使读、写和编辑散文变得容易。HTML是一种发布格式;Markdown是一种书写格式。因此,Markdown的格式语法只解决了可以用纯文本表达的问题。 对于未被Markdown语法覆盖的任何标记,只需使用HTML本身。

实际上,最好的方法是将每个代码块包装在一个<div>中,并为每个div分配适当的类。但是,大多数Markdown解析器并不在原始HTML块中解析Markdown。因此,您可能还需要在原始HTML中定义代码块。检查解析器的特性列表以找出答案。如果您无法定义您自己的CSS以单独使用Markdown (为HTML设置样式),您还需要在HTML中内联定义样式。这个问题包含了一个很好的示例,展示了它的样子。只需用适当的代码块替换注释即可。如果您必须用原始HTML定义代码块,它们将如下所示:

代码语言:javascript
复制
<pre><code class="language-c">int foo (void) 
{
    int i;
}
</code></pre>

所以,最后的文件,肯定会在所有(大多数?)减价解析器将如下所示:

代码语言:javascript
复制
# 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

票数 38
EN

Stack Overflow用户

发布于 2020-01-22 04:08:08

虽然这并不适用于所有的标记,但我将其用于GitLab、Github和mdBook。我想我可以分享这个答案。

基本上,您可以通过HTML创建表。标记和HTML并不是很好的混合,但是如果你用空格包围减价,有时可以识别减价。

https://docs.gitlab.com/ee/user/markdown.html#inline-html

代码语言:javascript
复制
<table>
<tr>
<th> Good </th>
<th> Bad </th>
</tr>
<tr>
<td>

```c++

int foo() {

代码语言:javascript
复制
int result = 4;
代码语言:javascript
复制
return result;

}

代码语言:javascript
复制
</td>
<td>

```c++

int foo() {

代码语言:javascript
复制
int x = 4;
代码语言:javascript
复制
return x;

}

代码语言:javascript
复制
</td>
</tr>
</table>
票数 39
EN

Stack Overflow用户

发布于 2019-01-13 01:17:26

这是一个老生常谈的问题,但如果人们从谷歌来到这里,上面的答案对于简单的真标记是正确的,但是如果您希望使用或通过实现克拉姆顿的方法来实现这个问题,kramdown确实支持混合的PHP标记额外和Markdown语法,就像kramdown docs 这里中提到的那样。kramdown只是要求在您打算使用上述HTML的标记页面中,向markdown="1"的包装HTML元素添加一个属性。

作为一个例子(以及两列标记的直接解决方案),这将导致内容的两列。我使用Bootstrap来处理列宽和图像对中,但是您可以对这些主题采取任何方法。

代码语言:javascript
复制
<div class="row">
  <div class="col-md-8" markdown="1">
  Some text.
  </div>
  <div class="col-md-4" markdown="1">
  <!-- ![Alt Text](../img/folder/blah.jpg) -->
  <img height="600px" class="center-block" src="../img/folder/blah.jpg">
  </div>
</div>

小心凹痕。我在上面的代码中没有缩进一个以上的级别。我相信默认情况下kramdown会将双缩进代码解释为一个引号块(如果我没记错的话,这通常是Markdown的标准)。

还请注意,我选择使用html img标记而不是标记图像链接。你可以选择这样做,因为你获得了一些额外的控制。

而且,如果您是新手或不熟悉引导,您可以通过更改上面代码中所示的8和/或4来更改相对列宽度,只需确保这两个数字的之和始终为12。

如前所述,这只适用于实现kramdown引擎的降价消费者(这对Jekyll用户来说非常好)。

票数 13
EN
页面原文内容由Stack Overflow提供。腾讯云小微IT领域专用引擎提供翻译支持
原文链接:

https://stackoverflow.com/questions/30514408

复制
相关文章

相似问题

领券
问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档