如何将 Markdown 风格文本转换为格式化 HTML 预览

先确认预览用途与输入状态

Markdown Preview 适合在整理说明文档、项目清单或带有链接的文字时，先查看 Markdown 风格标记会怎样呈现。它会把提交的非空文本转换成格式化的 HTML 预览，帮助你在继续编辑前观察标题层级、列表结构、引用内容和其他排版结果。文本输入是可选的，因此也可以先打开工具熟悉结果区域；省略内容或提交空文本时，操作仍会成功，只是预览区域保持为空。

按顺序提交内容并核对版式

在文本输入区域键入或粘贴准备检查的 Markdown 风格内容。可以先从标题、列表、链接或引用组成的短片段开始，以便更容易对照原文和预览。
执行预览操作，等待成功结果出现。若这次只想确认空白状态，可以不填写文本；省略输入与提交空文本的处理结果相同，预览不会自行补出示例内容。
查看格式化的 HTML 预览，逐项核对标题层级、表格样式行、分隔线、引用、图片、链接、强调、删除线、列表以及部分换行的显示情况。工具也覆盖围栏标记和行内标记等已定义模式，但不同写法需要分别观察。
如果版式与预期不同，回到输入区域检查标记的写法和位置，再重新执行预览。需要记录输入规模时，查看成功结果中的字符数；非空提交会提供原始文本的字符数，而不是预览内容的字符数。

从成功结果判断呈现范围

成功结果的核心是格式化的 HTML 预览，它反映的是当前输入经过已覆盖模式处理后的呈现。提交非空文本时，结果还会给出原始输入的字符数，可用来核对文本规模；这项数值不表示 HTML 预览中的标签数量。空输入则以成功操作和空预览为结果，不会因为缺少内容而自动生成文字。

看到预览并不等于所有 Markdown 写法都已被识别。标题从一级到六级、列表、链接、图片、引用、强调、删除线、代码相关标记、表格样式行、水平分隔线和部分换行属于已覆盖的模式，但其他语法可能不会按完整 Markdown 解析。遇到不一致的版式时，应把结果当作针对这些模式的预览来检查，而不要据此判断文本适合所有后续用途。

使用示例

你正在检查一份含有二级标题和无序列表的项目清单，希望确认这些结构在预览中的呈现。

在输入区域填写“## 项目清单；- 设计；- 测试”，执行预览后查看成功结果中的预览内容和字符数。

成功结果应包含格式化的 HTML 预览，并因输入不为空而附带原始输入的字符数。

使用限制

工具只呈现已定义的 Markdown 风格模式，不能视为对完整 Markdown 语法的全面支持。

常见错误

某段文字没有按预期排版，可能是它采用的写法不在已覆盖的模式中；请先换成已列出的标题、列表、链接、引用或其他支持形式，再重新执行预览。

常见问题

可以把 Markdown 文本转换成 HTML 预览吗？

提交非空内容后，成功结果会提供格式化的 HTML 预览；可检查的范围包括多级标题、列表、链接、图片、引用、强调、删除线、表格样式行、分隔线、部分换行以及已覆盖的代码相关标记。

不输入内容也能执行吗？

可以省略文本或提交空文本，操作仍会成功；这种情况下结果中的预览为空，不会生成额外内容。

结果会显示输入文本的字符数吗？

提交非空文本时，成功结果会附带原始输入的字符数；空文本只产生空预览，因此不提供这项非空文本统计。