什么是 GitHub 风味Markdown？

GitHub Flavored Markdown (GFM) 是 CommonMark 的超集，它添加了表、任务列表复选框、双波浪线和自动链接裸网址的超集。它是 GitHub 用于呈现自述文件的方言，在该转换器中默认启用。

转换器是否使我的代码块突出显示？

它发出标记高光者所需的:一个围栏块,例如```js 变成。转换器本身不会为代码着色 - 您在页面上添加像 Prism、highlight。js 或 Shiki 这样的高光者,它会自动拾取语言类。

我的Markdown中是否保留了原始html？

默认情况下它会转义,因此显示为文字文本而不是标签。打开"允许原始 HTML"选项可直接传递标签,这是当 Markdown 已混合在 HTML 中时您想要的 - 例如块或带有属性的内联。

为什么我的单行断线消失了？

Standard Markdown 将连续的行连接成一个段落;只有在用两个空格结束行或留下空行时,换行符才能保留。如果您希望每个换行符都成为 ,请启用"换行符"选项 - 即行为 GitHub 评论和许多聊天应用程序使用。

我可以从我的标题中生成一个目录吗？

是的。启用标题 ID 后,每个标题都会得到一个已加载的锚点,该工具会构建一个链接到每个标题的 Markdown 目录。将其复制回文档顶部,链接将针对生成的 ID 进行解析。

粘贴我没有写的Markdown是否安全？

是的。默认情况下会转义 HTML,并且实时预览还会删除脚本和样式标签、内联事件处理程序和 javascript: URL。您粘贴的任何内容都不会传输到任何地方 - 解析器完全在浏览器中运行。

该工具是否完全支持 CommonMark？

它实现了人们实际编写的结构 - ATX 和 setext 标题、段落、强调、链接、图像、自动链接、块引号、嵌套和松散列表、围栏和缩进代码、主题中断、反斜杠转义 - 加上 GFM 扩展。少数罕见的 CommonMark 角,例如参考样式链接和 HTML 段落中注释边缘情况,不包括在内。

如何将 readme.md 文件转换为 HTML？

在任何文本编辑器中打开 README,复制整个文件,然后将其粘贴到此处启用 GitHub Flavored Markdown 的编辑器中 - 即方言 GitHub 本身渲染 README,因此徽章、表格和任务列表都是一样的。然后下载完整的 HTML 文档导出,它将输出包装在 doctype 中,并从第一个标题中获取页面标题。

浏览器可以在不转换的情况下显示 Markdown 吗？

No。Browsers只渲染HTML,所以通过HTTP提供的。md文件显示为纯文本。必须先编译它 - 在构建时使用静态站点生成器,在服务器上的请求时间,在浏览器中使用JavaScript解析器,或者一次手持转换器,如此。

如何在节点或python中将markdown转换为html？

在 Node 中,公共库被标记并标记为"it";在 Python 中,markdown 或 markdown-it-py。将它们中的任何一个与消毒器配对 - JS 中的 DOMPurify 或 sanitize-html,Python 中的漂白剂 - 如果 Markdown 来自用户,因为这些解析器都不能单独剥离危险的 HTML。

Markdown到 HTML

Q: 转换器是否使我的代码块突出显示？

它发出标记高光者所需的:一个围栏块,例如```js 变成 。转换器本身不会为代码着色 - 您在页面上添加像 Prism、highlight。js 或 Shiki 这样的高光者,它会自动拾取语言类。

Q: 我的Markdown中是否保留了原始html？

默认情况下它会转义,因此 显示为文字文本而不是标签。打开"允许原始 HTML"选项可直接传递标签,这是当 Markdown 已混合在 HTML 中时您想要的 - 例如 块或带有属性的内联 。

使用 GitHub Flavored Markdown 支持将 Markdown 转换为干净的语义 HTML - 表、任务列表、围栏代码、标题锚、实时预览和完整的 HTML 文档导出。

Markdown

<h1 id="release-notes-v24">Release Notes - v2.4</h1>
<p>Ship notes for the <strong>June</strong> release. See the <a href="https://example.com/changelog">changelog</a> for the full diff.</p>
<blockquote>
<p>Heads up: the <code>/v1/export</code> endpoint is deprecated and will be removed in v3.</p>
</blockquote>
<h2 id="whats-new">What's new</h2>
<ul>
<li>Faster CSV export (~4x on 100k rows)</li>
<li>New <code>--dry-run</code> flag</li>
<li>Fixed a <em>nasty</em> race in the queue worker</li>
</ul>
<h3 id="upgrade-steps">Upgrade steps</h3>
<ol>
<li>Bump the package</li>
<li>Run the migration</li>
<li>Restart the workers</li>
</ol>
<pre><code class="language-bash">npm install toolz@2.4.0
npx toolz migrate --dry-run
</code></pre>
<table>
<thead>
<tr><th>Endpoint</th><th style="text-align:center">Status</th><th>Notes</th></tr>
</thead>
<tbody>
<tr><td>/v2/export</td><td style="text-align:center">stable</td><td>Use this</td></tr>
<tr><td>/v1/export</td><td style="text-align:center"><del>deprecated</del></td><td>Removed in v3</td></tr>
</tbody>
</table>
<ul class="task-list">
<li><input type="checkbox" disabled checked /> Docs updated</li>
<li><input type="checkbox" disabled /> Blog post scheduled</li>
</ul>
<hr />
<p>Questions? Reach us at <a href="mailto:support@example.com">support@example.com</a>.</p>

127

Words

Headings

Links

Images

Code blocks

1320

HTML bytes

1 min

Read time

Table of Contents

- [What's new](#whats-new)
  - [Upgrade steps](#upgrade-steps)

Category:docs

Mode:Offline

Version:1.0.0

Access:Free

什么是HTML转换器的Markdown？

Markdown to HTML interface on Toolz.dev - Convert Markdown to clean, semantic HTML with GitHub Flavored Markdown support - tables, task lists, fenced code, heading anchors, live preview and a full HTML document export.

Markdown 到 HTML 转换器将 Markdown 源(一个 README、一个更改日志、一个博客草稿、一组发布说明)转换为浏览器或 CMS 实际渲染的 HTML。在左侧粘贴或键入 Markdown,您将在右侧获得语义 HTML:标题变为 h1 hedh6,围栏代码变为 pre 和带有语言类的代码,列表变为 ul 和 ol,并且 GitHub 扩展(例如表、任务列表和删除线)按照 GitHub 渲染的方式处理它们。

Markdown是一种纯文本的写作格式,而不是显示格式,它出现在页面上的任何地方- 一个docs站点,一个静态博客,一个电子邮件模板,一个只接受HTML的CMS字段- 有些东西必须先在浏览器中做到这一点,而不是把解析器拉到你的构建中或将你的草稿粘贴到你不控制的服务中,这是最快的方法来获得标记并继续前进。

一切都在客户端运行。转换器是一个手写的解析器，而不是一个远程 API 的包装器，因此您未发布的帖子、内部文档和私有版本说明永远不会离开页面。 Toggle GitHub 风格化 Markdown、标题 ID、单换行符和原始 HTML 传递，然后复制 HTML、下载 .html 文件或获取生成的目录。

Markdown 允许原始 HTML 内联,这使得安全问题是真实的而不是理论的:包含脚本标签的文档是有效的 Markdown,而传递它的转换器会产生 HTML,当渲染时会运行,这里的输出默认情况下会转义,因此来自不受信任源的 Markdown 文件无法将标记偷偷带入您的页面,如果您正在转换自己的内容并希望保留原始 HTML,那是故意的选择而不是默认的,另一件事要知道的是 Markdown 没有单一的规范,这里实现了 GitHub Flavored Markdown,它涵盖了表、任务列表、删除线和围栏代码,而这些都是扩展而不是原始语法的一部分,因此严格的 CommonMark 渲染器不会显示它们。

如何使用 Markdown 到 HTML 转换器？

粘贴您的Markdown

Markdown键入或粘贴到编辑器中 - 一个README,一个更改日志,来自编辑器的笔记,任何东西。输出更新,因为你输入;加载样本,如果你想看到支持什么。

选择您的选项

为表格、任务列表、删除线和裸网址链接打开 GitHub 风格的 Markdown。添加深层链接的标题 ID，如果单个换行符应该变成 <br />，则启用换行符，如果您的Markdown已经包含标签，则允许原始 HTML。

检查预览

HTML 源和渲染预览之间切换,以确认结构是您所期望的,并读取文档统计信息 - 字、标题、链接、代码块和读取时间。

复制、下载或使用 TOC

将 HTML 复制到剪贴板，将其作为独立的 .html 文件下载，或复制从标题锚点构建的自动生成的 Markdown 目录。

主要特点

GitHub 口味的Markdown

带有列对齐、任务列表复选框、~~删除线~~和裸露 URL 自动链接的表格 - 您的 README 已经依赖的扩展

语言类的围栏代码

被围栏的块变成 <pre><code class="language-js">，类名 prism, highlight.js 和 shiki 期望，因此语法突出显示在将输出粘贴到您的站点的那一刻起作用

航向锚和TOC

每个标题都会有一个经过重写、去复制的 ID,该工具会生成一个匹配的 Markdown 目录,您可以粘贴回文档顶部

默认安全

源(source)中的原始HTML被转义,除非你选择加入,并且实时预览会剥离脚本,样式和内联事件处理程序 - 因此粘贴别人的Markdown无法运行他们的代码

Frequently Asked Questions

Markdown粘贴到编辑器中,HTML立即出现 - 没有转换按钮按下,也没有文件上传如果您的源使用表格或任务列表,则切换GitHub风味Markdown,然后复制HTML或将其下载为。html文件。

Related Tools

docs

HTML Formatter

Format, beautify, and minify HTML online. Re-indents messy or minified markup, keeps script, style, and pre content verbatim, and runs entirely in your browser.

HTM

docs

HTML to Markdown

Convert HTML to clean Markdown instantly. Turns headings, lists, links, images, blockquotes, code blocks and tables into portable GitHub Flavored Markdown. Tolerant of messy CMS markup. 100% client-side.

MTG

docs

Markdown Table Generator

Build Markdown tables in a spreadsheet-style editor - import CSV, Excel, or an existing table, set alignment, copy clean GFM

MTG

docs

Markdown TOC Generator

Generate a linked table of contents from Markdown headings

Comments

0 comments

No comments yet. Be the first to share your thoughts!

markdown to htmlmarkdown convertermd to htmlmarkdown compilermarkdown previewgithub flavored markdownmarkdown rendererconvert readme to htmlmarkdown parser

了解更多

阅读完整的 Markdown到 HTML 指南

Command Palette

Markdown到 HTML

什么是HTML转换器的Markdown？

如何使用 Markdown 到 HTML 转换器？

粘贴您的Markdown

选择您的选项

检查预览

复制、下载或使用 TOC

主要特点

GitHub 口味的Markdown

语言类的围栏代码

航向锚和TOC

默认安全

Frequently Asked Questions

Related Tools

HTML Formatter

HTML to Markdown

Markdown Table Generator

Markdown TOC Generator

Comments

了解更多