【问题标题】:Markdown tabs in GitLab MarkdownGitLab Markdown 中的 Markdown 选项卡
【发布时间】:2019-01-07 02:55:51
【问题描述】:

我正在编写包含适用于 Windows、Mac、Linux 的步骤的文档。 我想让它看起来像这个HTML5标签HTML5 example 支持HTML in gitlab markdown 有一个sanitation 类的引用,它验证了 gitlab markdown 中的内联 HTML

我的问题是:

  • 实现选项卡式文档的建议。是否有在 Markdown 中正确显示 CSS 的解决方法?

  • 如何做到这一点?

【问题讨论】:

    标签: gitlab markdown code-documentation


    【解决方案1】:

    只需将相关的 HTML/CSS/JS 插入到您的 Markdown 文档中。

    作为 Markdown 的 Syntax Rules 状态(重点是原文):

    Markdown 的语法有一个目的:用作一种格式 为网络写作

    Markdown 不是 HTML 的替代品,甚至更接近它。它的 语法非常小,只对应一个非常小的子集 HTML 标记。这个想法是不是来创建一个更容易的语法 插入 HTML 标签。在我看来,HTML 标签已经很容易 插入。 Markdown 的想法是使其易于阅读、编写和 编辑散文。 HTML是一种发布格式; Markdown 是一个写作 格式。因此,Markdown 的格式化语法只解决了以下问题 可以以纯文本形式传达。

    对于 Markdown 语法未涵盖的任何标记,您只需 使用 HTML 本身。无需为其添加前缀或将其定界为 表明您正在从 Markdown 切换到 HTML;你只是用 标签。

    唯一的限制是块级 HTML 元素——例如<div>, <table><pre><p>等——必须与周围分开 内容由空行组成,块的开始和结束标记应 不能用制表符或空格缩进。 Markdown 不够聪明 在 HTML 块级标签周围添加额外的(不需要的)<p> 标签。

    然而,这也有不利的一面:

    请注意,Markdown 格式化语法不在块级内处理 HTML 标记。例如,你不能使用 Markdown 风格的 *emphasis* 在 HTML 块。

    最后,您似乎希望将此文档托管在第三方网站上(可能在 Gitlab 上的自述文件中)。大多数处理和托管 Markdown 文档的第三方站点(包括 Gitlab)出于安全原因(以避免 XSS 附加等)通过 HTML 清理程序运行输出。因此,您可能会发现您的 HTML 中的各种必需的钩子将被剥离,并且无法正常工作。当然,在您拥有完全控制权的您自己的网站上,这不是问题。

    【讨论】:

    • 感谢您的回答。我试过了,html标签被剥离了。不幸。
    【解决方案2】:

    该解决方案在 Microsoft VsCode 使用的文本处理器的 readme.rd 中进行了尝试,并提交给了 gitlab。在附图中有渲染。这并不像预期的那样。也许很快就会有标签功能。

    【讨论】:

      猜你喜欢
      • 2021-10-21
      • 2021-05-20
      • 2021-06-24
      • 1970-01-01
      • 1970-01-01
      • 1970-01-01
      • 2019-11-14
      • 2015-04-17
      • 1970-01-01
      相关资源
      最近更新 更多