跳到主要内容

内容呈现:Markdown To HTML

使用 markdown-js 库将 Markdown 转换为 HTML,该库遵循 John Gruber 的原始语法。源文本中的原始 HTML 会作为文本转义,表格和围栏代码块等 GitHub 扩展不会被识别。

把 README 的某一节或发布说明粘贴到只接受 HTML 的 CMS 字段中。

Markdown

适用场景

  • 把 README 的某一节或发布说明粘贴到只接受 HTML 的 CMS 字段中。
  • 查看一段基础 Markdown 会生成哪些 HTML 标签。

使用方法

  1. 将 Markdown 粘贴到左侧编辑器,或加载 .md 文件。
  2. 阅读右侧生成的 HTML,并在下方的渲染预览中检查每个标题、列表和链接。
  3. 复制 HTML;其中只有正文标记,请在粘贴的位置自行添加 CSS。

Markdown

## Install

Run the **CLI** once:

    npm install -g douni

1. Open the [docs](https://douni.one)
2. Paste your file

| a | b |

HTML

<h2>Install</h2>

<p>Run the <strong>CLI</strong> once:</p>

<pre><code>npm install -g douni</code></pre>

<ol>
  <li>Open the <a href="https://douni.one">docs</a></li>
  <li>Paste your file</li>
</ol>

<p>| a | b |</p>

功能与限制

转换在浏览器中进行。输出是 HTML 片段,不含 <html>、<head> 或样式表;预览在禁用脚本的沙箱框架中渲染。

只支持原始 Markdown。管道表格、任务列表、~~删除线~~ 和 ``` 围栏代码会保留为文本;代码块请使用 4 空格缩进。

像 <div> 这样的行内 HTML 会被转义为 &lt;div&gt;,不会原样输出。

图片会变为指向原始 URL 的 <img> 标签;文件不会被嵌入。

FAQ

为什么我的 ``` 代码围栏没有变成 <pre> 块?

该库早于围栏代码出现。围栏会被当作段落中的行内代码。将代码缩进四个空格即可得到 <pre><code>。

支持 GitHub Flavored Markdown 表格吗?

不支持。像 | a | b | 这样的行会输出为普通段落。

能在 Markdown 中保留原始 HTML 吗?

不能。HTML 标签会被转义并在结果中显示为文本,因此嵌入的 <div> 不会渲染为元素。

规范与参考资料