跳到正文

将Markdown转换为HTML

把Markdown转成精美的独立网页,或转成可直接粘贴到博客、CMS中的简洁HTML——支持GitHub风格表格、代码高亮和可链接的标题。

  • 绝不存储
  • 无需排队,无需等待
  • 无需注册,无水印

手头没有文件?

使用方法

1

添加Markdown

拖放.md文件,或直接在编辑器中输入、粘贴。

2

选择输出方式

可在任何地方打开的完整样式网页,或只要HTML,用在您自己的网站上。

3

复制或下载

将HTML复制到剪贴板,或保存为.html文件。

片段还是网页,您需要哪一个

有两种实用的输出方式,而且不能互换。片段只是转换后的标记——标题、段落、列表、链接——没有文档外壳,适合把结果放进模板、CMS字段或其他网页中。完整网页则加上了doctype、head、字符集声明和样式表,因此可以单独打开,而且看起来像样。把完整网页粘贴进CMS,会得到文档套文档;把片段直接在浏览器中打开,只会看到没有样式的文字。

转换支持业界普遍认可的扩展Markdown语法:标题、强调、列表、链接、图片、引用块、表格、带语法高亮的围栏代码块、任务列表、删除线和脚注。标题会根据其文字生成标识符,因此可以直接链接到标题——正是这些锚点链接让长篇文档便于使用。

Markdown中的原始HTML会原样保留,这是规范的一部分,值得您认真对待:这意味着来源不可信的Markdown文件可能包含script标签,转换后生成的网页也会带上这段脚本。切勿渲染陌生人提供的Markdown而不在之后对HTML进行净化——转换本身不是安全边界,也从来不是为此设计的。

有两类内容会刻意以代码块形式输出,而不进行渲染。LaTeX写法的数学公式需要排版库,Mermaid图表需要图表渲染器——两者都是分量不小的依赖,而渲染错误的公式比原样显示的公式更糟。完整网页使用普通的系统字体,不从网络加载任何字体,因此可以离线使用,但在Windows、macOS和Linux上看起来会略有不同。

如果您需要的是别的

Pandoc能处理这里省略的部分,还能做更多:pandoc in.md -o out.html --mathjax --standalone --toc可以正确渲染数学公式、生成目录,还支持模板,让输出与您自己的网站风格一致。它还能与大约四十种其他格式互相转换,因此值得安装一次。

如果要做的是网站而不是单个文件,请使用静态网站生成器,而不是一页一页地转换。Hugo、Eleventy、Jekyll和MkDocs可以把一个Markdown文件夹生成带导航、搜索和统一样式的网站,并在源文件变化时自动重新构建——只要文档不止一份,这才是真正要做的事。

常见问题

完整网页还是HTML片段——我该选哪个?

完整网页是一个自带样式的.html文件,无论从桌面打开、在手机上查看还是打印出来都很美观。片段只包含正文标记,不带样式,适合粘贴到WordPress、Ghost、CMS或您自己的模板中。

支持哪些Markdown功能?

支持GitHub风格Markdown:可设置对齐的表格、任务列表、删除线、自动链接、带语法高亮的围栏代码块、脚注和内联HTML。标题会生成GitHub风格的id,因此#installation这类链接依然有效。

我的文本会被存储吗?

不会。不会发送到任何地方,也不存储任何内容。

我的图片会怎样处理?

图片路径与您写的完全一致,因此只要把网页保存在图片文件夹旁边就能正常显示。您也可以把图片一起拖进来,它们会被嵌入文件中,让文件可以单独使用。

生成的HTML可以放心发布吗?

Markdown中所含HTML里的脚本、表单、嵌入框架和内联事件处理程序都会被移除,因此输出结果只包含格式。

可以添加目录吗?

可以——勾选“目录”,或在您希望放置目录的位置单独写一行[TOC]。

小贴士: 数学公式和Mermaid图表会以代码块形式输出,不会渲染。完整网页使用网页安全的系统字体,因此在Windows、macOS和Linux上的显示效果会略有差异。

把这个工具放到您的网站上

博客、课程页面或帮助文章均可免费使用。粘贴一段代码,访客就能直接在您的页面上使用。