0

我正在编写一个脚本,从源文件中提取 markdown 片段并生成一个 .md 文件,该文件被馈送到基于 CommonMark (rust / pulldown-cmark 0.7.0) 的文档系统。在最终的 .html 结果中,我希望这些片段显示为定义列表 ( <dl>)。实现这一目标的最佳方法是什么?

我尝试了三种方法(在这里渲染)

  1. 拥抱 HTML 是 md,并让generated.md包含内联 HTML:
<dl><dt>title</dt><dd>defintion with <code>markup</code></dd></dl>

这给出了正确的结果,但不可接受,因为它要求将源文件编码为 HTML。

  1. 带有嵌入式降价的嵌入式 HTML:
<dl><dt>

title
</dt><dd>

definition with `markup`
</dd></dl>

这可行,但标题和定义被包裹在<p>结果中的一个元素中,这会产生多余的间距。

  1. 使用纯降价和虚线列表:
* **title**

  definition with `markup`
  1. 通过添加呈现相同的标记来模拟 a 的外观。使用我正在使用的 CSS,以下工作:
title
> definition with `markup`

...但是生成的 .html 与其他 CSS 看起来很糟糕。

我的问题是是否可以改进 2 以提供更好的布局,或者我是否需要接受 3 或 4 的丑陋。

4

0 回答 0