标签: kramdown

我正在使用Jekyll创建一个文档站点,其中我试图记录一些包含句柄式语法的代码.例如{{foo}}.问题是Jekyll使用液体标签,无论我做什么,我的双层玻璃都会被液体处理器撕掉.

顺便说一句,我使用kramdown作为降价处理器.

这是我尝试过的东西:

{% highlight html linenos %}
  Hello, my name is {{name}}.
{% endhighlight %}

这个完全删除了{{name}}部分,因为它认为它是对液体变量的引用.

我也试过这个:

{% highlight html linenos %}
  Hello, my name is \{\{name\}\}.
{% endhighlight %}

在这种情况下,我试图逃避花括号,但结果是斜杠被渲染到页面中.

我甚至试过这个:

{% highlight html linenos %}
  Hello, my name is <span>{</span>{name}}.
{% endhighlight %}

不可否认,这个非常愚蠢.在这种情况下,因为我已将语法指定为html(它需要),所以span标记将呈现到页面中.

那么我可以如何解决这个问题呢？

我正在使用Jekyll默认kramdown.我有一张表显示使用

surround text, etc.

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

surround text...

但桌子没有边框.如何显示边框.

根据Kramdown文档,设置选项parse_block_html应允许在html块内处理markdown(Kramdown)语法.

在我_config.yml,我有如下设置:

---
name: Blog Name
markdown: kramdown
kramdown: 
  parse_block_html: true
---

然后在.md文件中,我尝试类似:

# Headline1
------------

<div>
  # Headline2
  ------------
</div>

div中的降价内容不会转换为HTML jekyll build.我错过了什么？(另外,有没有更简单的方法在任何其他markdown语法中执行此操作,例如RedCarpet？)

我有一个Jekyll网站,使用Kramdown解析器在Markdown中编写Posts.

我想在帖子中添加一些原始HTML.然而,当我尝试添加HTML,它解析它降价(改变<的,以<为例).

我试过了:

• 在自己的段落中添加HTML.
• 包括一个.html文件.
• 添加markdown="0"到HTML标记(也尝试过1).
• 使用以上所有内容进行缩进(并以三重反向打包).
• 使用原始标签

我的例子:

Some **markdown** `here`

<iframe src="asd"></iframe>

More *markdown*.

iframe应该输出为HTML,而不是解析文本.

我正在使用Github页面,因此Jekyll扩展不是可选的.

我正在努力建立我的第一个jekyll博客.我正在尝试运行jekyll服务器,但在将其键入终端后,我收到错误消息:

You are missing a library required for Markdown. Please run:
$ [sudo] gem install kramdown
Conversion error: Jekyll::Converters::Markdown encountered an error while converting '_posts/2013-08-15-immunize-canada-app.md/#excerpt':
                Missing dependency: kramdown
         ERROR: YOUR SITE COULD NOT BE BUILT:
                ------------------------------------
                Missing dependency: kramdown

我已经安装了kramdown,但仍然收到此错误.我在另一篇文章中发现将gem'kramdown'添加到Gemfile中,但仍无效.我是Ruby/Jekyll的新手,所以任何帮助都会非常感激!

我正试图在我的Jekyll网站上的页面(而不是帖子)上使用Kramdown的自动"目录"生成器.

_includes/toc.html

<nav>
  <h4>Table of Contents</h4>
  {:toc}
</nav>

my_cool_stuff/my_cool_page.md

---
layout: page
---

{% include toc.html %}

# The title of my page
## The Subtitle of my page

HTML是按字面生成的,我没有得到标题列表.

<nav>
  <h4 class="toc_title">On This Page</h4>
  {:toc}
</nav>

我设置错了什么？

我尝试使用以下语法将我的 GitHub 页面上的 Markdown 列表项设为超链接：

  1. [Caption]: https://example.com
  2. Another list item

与直观的预期相反，它呈现为以下 HTML 代码

<ol>
  <li></li>
  <li>Another list item</li>
</ol>

这怎么可能解决？是否有正确的语法？我的目的是创建一个用于撰写文章的信息来源的可点击列表，并将其放在文章的底部。

据我所知,CSS无法指定链接的target属性<a>.我希望能够使用以下输出在基于Jekyll的markdown文档中生成外部链接:

<a href="the-url" class="external" target="_blank">the text</a>

不诉诸这样的事情:

[the text](the url){:target"_blank" class="external"}

我不想target在每个链接中硬编码,因为我可能想在某个时候改变它,也是吵闹.理想情况下,我会有

[the text](the url){:class="external"}

...但是CSS无法添加target="_blank".

所以我的想法是一个允许我写的自定义插件

{% ext-link the-url the text %}

这样的插件存在吗？有没有更好的方法来实现这一目标？

我kramdown在Github Pages上使用Jekyll.我有一个降价我想要使用两次,并且不想维护它的两个版本.如何将其包含在其他降价文件中？

例如,我想键入类似的东西

{: include otherFile.md }

并otherFile.md在此命令所在的位置直接呈现内容.请注意,父文件也是markdown文件,而不是HTML模板.

额外的考虑:能够使用默认的GitHub页面工作流来完成这项工作会很棒,而不必使用GH页面禁用的插件,并且必须手动推送站点的编译版本.

我有一个Jekyll网站,使用kramdown进行降价.在_config.yml我有以下设置,以确保只有<h2>和<h3>元素显示在自动生成的目录中:

kramdown: 
  toc_levels: "2,3" 

这工作正常,但在某些页面上我也希望<h4>在TOC中包含元素,同时保留其他页面上的现有<h2>和<h3>配置.这可能吗？

在任何页面上,我都可以访问如下_config.yml定义:

{{ site.kramdown.toc_levels }} 

有没有办法设置toc_levels页面的值？