问题标签 [kramdown]

For questions regarding programming in ECMAScript (JavaScript/JS) and its various dialects/implementations (excluding ActionScript). Note JavaScript is NOT the same as Java! Please include all relevant tags on your question; e.g., [node.js], [jquery], [json], [reactjs], [angular], [ember.js], [vue.js], [typescript], [svelte], etc.

0 投票
2 回答
7108 浏览

markdown - Jekyll raw HTML in post

I have a Jekyll website, with Posts written in Markdown using the Kramdown parser.

I would like to add some raw HTML within the post. However when I try to add the HTML, it parses it as markdown (changing <'s to &lt; for example).

I have tried:

  • Adding the HTML in its own paragraph.
  • Including a .html file.
  • Adding markdown="0" to the HTML tag (also tried 1).
  • Indenting (and wrapping in triple back-tick) with all of the above.
  • Using raw tags

Example of what I have:

The iframe should be output as HTML, not parsed text.

I am using Github pages, so Jekyll extensions are not optional.

0 投票
2 回答
1322 浏览

markdown - kramdown 中的三级嵌套列表

我一直在尝试创建一个嵌套列表,如下所示(使用 kramdown,用于 GitHub 页面),但 HTML 输出不是语义的;第二级列表使用段落代替列表元素,第三级列表项使用代码块。

以上产生以下HTML ...

我曾尝试更改缩进,甚至删除项目之间的空白行,但无法使其按预期运行。

用而不是实际数字替换所有列表“项目符号”1.确实可以生成结构正确的 HTML(感谢Scroog1的离线建议);然后可以使用 CSS 使输出的 HTML 列表具有所需的list-style-type. 然而,这感觉与 Markdown 的“它应该像纯文本一样可读”的理念相反,所以我想知道是否有任何方法可以使它工作在 Markdown 版本中看起来像预期的那样?

(我想可以说,在这种特殊情况下,HTML 是我的文档的唯一格式,人们会阅读,最好让机器进行编号,并且使用 CSS 而不是由生成的内联样式更简洁降价处理器来实现所需的列表格式,但我很好奇上述失败是否可能是我对 kramdown 的误用,或者可能是错误或设计决策。)

0 投票
1 回答
487 浏览

github - kramdown 中的乳胶 \newcommand

我知道 cramdown 不支持 \newcommand 类型的宏。是否有不涉及 Pandoc 的解决方法,以便它可以在 GitHub 博客中与 Jekyll 一起使用?

这将是输入降价:

输出应该是一个 Jekyll 博客,带有数学符号,像这样

0 投票
1 回答
293 浏览

ruby - 如何通过 Rake 将选项传递到 Yard 到 Kramdown 以使用 GFM

我用一些用Github Flavored markdown (GFM) 编写的文档制作了一个 gem,以利用它们的语法突出显示。

不幸的是,Github 决定使用他们自己的代码块屏蔽语法(三个反引号),以便让Yardoc正确解析,我选择了 Kramdown 作为解析器,它支持 GFM

最重要的是,当我将代码推送到 Rubygems 时,将通过运行 Rake 任务生成文档(据我所知)。所以我需要找到一种方法,通过 Rake 告诉 Yard 使用 Kramdown GFM 解析器。

Kramdown 通过-i开关选择解析器:

但我不知道如何让 Yard 通过yard二进制或 Rake 传递它。我想这可以通过创建一个 Yardoc 插件来实现,但我从来没有这样做过,也不确定它是否会起作用,而且看起来事情在这一点上会失控!

真正想要的是一个降价标准,但这与其说是一个未实现的愿望的问题......

对此的任何帮助将不胜感激。

0 投票
5 回答
6681 浏览

ruby - Jekyll/Ruby Kramdown 缺少依赖

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

我已经按照要求安装了 kramdown,但仍然收到此错误。我在另一篇文章中发现将 gem 'kramdown' 添加到 Gemfile,但仍然无法正常工作。我是 Ruby/Jekyll 的超级新手,所以非常感谢任何帮助!

0 投票
1 回答
54 浏览

ruby-on-rails - Jekyll 博客高亮代码生成无效的 html

使用 Jekyll,我有这个文件:

这是生成的html:

如果您将 html 放入这样的验证器中:https ://validator.w3.org/nu/ 您可以看到:

似乎html不正确,您可以在此处查看参考:http ://www.w3.org/TR/html401/struct/text.html#h-9.3.1 事实上p标签不能包含块级标签

Jekyll 为我生成 html,但我无法修复该行为。这似乎是一个错误。

这是我的_config.yml

你能帮助我吗?

0 投票
2 回答
979 浏览

ruby - 支持在 Markdown 中为图片添加延迟加载

我正在使用 kramdown 解析器将 Markdown 转换为 html。我想在不修改原始降价语法的情况下对图像使用延迟加载。我可以通过在 kramdown gems 中编辑 link.rb 文件来实现这一点。

在此处输入图像描述

但我不想走这条路。因为如果有人更新 kramdown 我会丢失这些编辑。有没有其他方法可以在不修改原始图像语法的情况下做到这一点?

原始图像语法:![](some image link)

当前输出(无上述编辑):<img src="some image link" alt=""/>

预期输出:<img data-src="some image link" alt=""/>

0 投票
3 回答
2333 浏览

css - Jekyll 语法突出显示不起作用 - 未添加类

我无法在 Jekyll 驱动的博客上使用语法高亮。

开发文件可以在这里找到:https ://github.com/StevenXL/stevenxl.github.io 。

如您所见,在我的_config.yml文件中,我有以下内容:

在我的css/custom.css文件中,我正在导入 CSS 文件以使用 @import 命令突出显示语法。

用于突出显示的实际 CSS 文件位于css/monokai.css.

我不确定我做错了什么。当我运行时,这似乎在我的本地预览中运行良好jekyll serve,但当我将开发文件推送到 GitHub 时,它似乎没有在由 GitHub 构建时添加正确的类。

0 投票
3 回答
445 浏览

css - 在列表中添加代码块时降价显示不正确

我在我的 jekyll博客中使用 pygments 和 kramdown 。

我尝试将代码块添加到降价列表,但显示不正确。

2015-10-29 6 39 28

生成的html:

但如果我这样写,那是没有问题的。

2015-10-29 6 41 37

这是 pygments 还是 kramdown 问题?希望有人可以帮助我,在此先感谢!

0 投票
0 回答
294 浏览

markdown - 使用 NSTask 在 kramdown 中使用 rouge 突出显示语法

我正在为 OS X 编写一个小型降价编辑器。到目前为止,我可以将降价转换为 HTML 并让它出现在我的网络视图中。我还没有管理的是启动和运行语法高亮。我正在使用kramdownmarkdown -> HTML 位,它的文档建议可以使用rougecoderay来完成突出显示。我用rouge去了,但没有取得太大的成功。这是我设置任务的方式:

这是我的降价示例:

当我运行任务时,我没有收到任何错误消息,并且我可以使用传递给的参数来切换行号--syntax-highlighter-opts,所以我认为参数的语法是正确的,但其他东西显然不是 - 我可以提取html,但没有语法高亮显示。