先看结论
- Markdown 是一种用文本符号表达文档结构、可转换为 HTML 的纯文本写作格式,但不同变体之间不保证兼容。
- 在 Windows 或 Mac 上,启动纯文本编辑器,通过“打开”选择文件即可阅读和编辑源文本;在手机上,使用能打开纯文本文件的应用。若要在浏览器中查看排版效果,使用支持文档所用 Markdown 变体的转换器生成 HTML,并检查实际输出。
- 作为纯文本阅读时风险相对较低,但恶意 Unicode 控制字符可能改变文字显示方向。预览或转换为 HTML 时,可能引入脚本执行、页面重定向、远程内容下载和个人信息上传风险。应检查并净化或阻止有风险的输出标记,参见 [RFC 7763 第 2 节](https://www.rfc-editor.org/rfc/rfc7763.html#section-2)。
Markdown 文件(.md、.markdown)怎么打开与转换
.md 和 .markdown 文件保存可直接阅读的源文本。原始语法支持标题、列表、引用、代码、强调、链接和图片等结构。参见[原作者的 Markdown 介绍](https://daringfireball.net/projects/markdown/)。
将 Markdown 转成 HTML 时,应选择支持源文件变体的转换器,再对照源文本检查结果。原始语法允许嵌入 HTML,但块级 HTML 内的 Markdown 标记不会继续解析。参见[原始语法说明](https://daringfireball.net/projects/markdown/syntax)。
怎么打开
在 Windows 或 Mac 上,启动纯文本编辑器,通过“打开”选择文件即可阅读和编辑源文本;在手机上,使用能打开纯文本文件的应用。若要在浏览器中查看排版效果,使用支持文档所用 Markdown 变体的转换器生成 HTML,并检查实际输出。
在 Windows 或 Mac 上,启动纯文本编辑器,通过“打开”选择文件即可阅读和编辑源文本;在手机上,使用能打开纯文本文件的应用。若要在浏览器中查看排版效果,使用支持文档所用 Markdown 变体的转换器生成 HTML,并检查实际输出。
将 Markdown 转成 HTML 时,应选择支持源文件变体的转换器,再对照源文本检查结果。原始语法允许嵌入 HTML,但块级 HTML 内的 Markdown 标记不会继续解析。参见[原始语法说明](https://daringfireball.net/projects/markdown/syntax)。
文件安全
作为纯文本阅读时风险相对较低,但恶意 Unicode 控制字符可能改变文字显示方向。预览或转换为 HTML 时,可能引入脚本执行、页面重定向、远程内容下载和个人信息上传风险。应检查并净化或阻止有风险的输出标记,参见 [RFC 7763 第 2 节](https://www.rfc-editor.org/rfc/rfc7763.html#section-2)。
来路不明、文件名带两个后缀,或者内容和扩展名对不上——先停下来核对。
转换格式
将 Markdown 转成 HTML 时,应选择支持源文件变体的转换器,再对照源文本检查结果。原始语法允许嵌入 HTML,但块级 HTML 内的 Markdown 标记不会继续解析。参见[原始语法说明](https://daringfireball.net/projects/markdown/syntax)。
先复制一份原文件再转换,转完对照看看画质、元数据和排版有没有变。
常见问题
MARKDOWN 文件是什么格式,用来做什么?
MARKDOWN 文件是使用 Markdown 语法的纯文本文档,常见扩展名为 .md 和 .markdown。它用符号表达标题、列表、链接等结构,可直接阅读和编辑,也可转换为 HTML。
Windows 怎么打开 MD 文件?
启动纯文本编辑器,通过“打开”选择 .md 文件,即可阅读和编辑源文本。若需要排版后的视图,还需要支持文档所用 Markdown 变体的渲染工具。
Mac 怎么打开 Markdown 文件?
在纯文本编辑器中通过“打开”选择文件,即可查看源文本。若要查看排版效果,使用支持该文件 Markdown 变体的预览工具。
手机怎么打开 Markdown 文件?
用能打开纯文本文件的应用阅读源文本。若希望看到排版效果,选择带 Markdown 预览功能的应用,并确认其支持文档使用的变体。
Markdown 文档如何在线预览?
使用支持文档变体的 Markdown 预览服务,或先转换成 HTML,再用浏览器查看。是否上传文件、是否过滤嵌入的 HTML,取决于具体服务,不能仅凭“在线预览”判断。
Markdown 不同编辑器显示不一致,或者转换后格式丢失怎么办?
先核对编辑器或转换器支持的 Markdown 变体。不支持的语法可能被忽略或采用不同解释。还要检查相关内容是否位于块级 HTML 中:原始 Markdown 不会解析其中的 Markdown 标记。
写文档时 Markdown 和 HTML 应该选哪个?
需要用易读的纯文本表达基本文档结构时,可选 Markdown;需要直接表达页面标记时,可选 HTML。Markdown 可以转换成 HTML,原始语法也允许直接嵌入 HTML。
Markdown 文件怎么转换成 HTML 并尽量保留格式?
选择支持源文件 Markdown 变体的转换器,转换后对照源文本检查标题、列表、链接及嵌入 HTML。不同变体间不保证保留效果;原始语法也不会解析块级 HTML 内的 Markdown 标记。
Markdown 预览会执行 HTML 脚本吗,打开陌生文件安全吗?
如果预览器允许有执行能力的嵌入 HTML,就可能执行脚本,也可能发生重定向、远程下载或个人信息上传。陌生文件可先作为纯文本查看,预览时应使用能净化或阻止有风险标记的工具;纯文本显示也并非没有 Unicode 显示方向风险。
Markdown 文件的 MIME 类型是什么,有固定文件头吗?
RFC 7763 登记的 MIME 类型为 text/markdown,扩展名为 .md 和 .markdown。该登记明确没有魔数,因此没有可用于识别的固定字节签名。
相关格式
资料来源
Daring Fireball: Markdown · 格式原作者 John Gruber 的官方网站
Markdown Syntax Documentation · 格式原作者发布的语法说明
RFC 7763: The text/markdown Media Type · IETF 发布的 Markdown 媒体类型注册文档