.md 文件是什么？如何打开、编辑和转换

.md 文件里到底存了什么

.md 文件保存普通文字和少量结构标记。井号表示标题层级，减号可以开始列表，方括号与圆括号组合成链接。因为这些符号仍然接近自然文字，即使没有专用软件，人也能大致读懂内容。

渲染器读取这些标记，再生成格式化结果。GitHub 会把仓库里的 README.md 渲染成项目介绍；VS Code 的预览会把代码块、表格和链接显示出来；普通记事本只负责展示源文本，不会替你渲染。

# 项目说明

这是一个 **Markdown 文件**。

- 安装依赖
- 运行测试

“项目说明”显示为一级标题；“Markdown 文件”显示为粗体；最后两行显示为项目列表。

README.md 是特殊格式吗

不是。README.md 与 notes.md、guide.md 使用同一种文件格式。README 只是约定俗成的文件名，用来介绍一个项目或目录。

在 GitHub、GitLab 等代码托管平台中，仓库根目录的 README.md 通常会自动出现在项目首页。它常包含项目用途、安装方法、示例、许可证和贡献说明。换一个文件名，Markdown 语法本身并不会改变。

打开 MD 文件前，先决定你要看源码还是排版

需要修改符号和文字时，用文本编辑器或代码编辑器。需要检查文章最终显示时，用 Markdown 预览。很多困惑来自把这两个动作混为一谈：记事本显示 `## 安装` 是正常的源码，预览才会把它显示成二级标题。

在 Windows 中打开和创建 .md 文件

Windows 记事本、VS Code 和其他代码编辑器都能打开 .md。系统如果询问使用哪个应用，选择能处理纯文本的程序即可。想同时看排版结果，VS Code 可以打开 Markdown 预览，在线编辑器也可以把源码和结果并排显示。

1. 用纯文本方式创建文件在记事本或代码编辑器中输入 Markdown，不要使用会自动保存富文本格式的应用。
2. 选择“另存为”文件类型选择“所有文件”，编码优先选 UTF-8。
3. 输入完整文件名保存为 notes.md。若得到 notes.md.txt，先在资源管理器中显示文件扩展名，再修正名称。

在 macOS、Linux 和 VS Code 中打开 MD 文件

macOS 的 TextEdit 可以读文本，但创建文件前应选择“格式 → 制作纯文本”。富文本模式保存的不是正常 Markdown 源文件。更方便的方法是使用 VS Code 或专用 Markdown 编辑器。

Linux 上任何纯文本编辑器都可以打开 .md。是否显示排版取决于应用，而不是操作系统。VS Code 内置 Markdown 预览：打开文件后可使用 Ctrl+Shift+V；macOS 对应 Cmd+Shift+V。

浏览器能直接打开 .md 吗

浏览器可能显示原始文本，也可能由网站界面渲染。GitHub 渲染 README，是 GitHub 的页面逻辑在工作；本地把 .md 拖进浏览器，不代表浏览器会自动按 Markdown 排版。服务器返回的 Content-Type、站点脚本和浏览器扩展都会影响结果。

如果只是想临时查看本地文件，使用明确标注“Markdown 预览”的工具更可靠。文件打开后仍应能看到源码，避免只能看、不能修。

常见 MD 文件问题

多数问题出在文件名、打开方式和资源路径，而不是文字本身。

什么时候需要把 MD 转成别的格式

Markdown 适合作为长期维护的源文件，但接收者不一定使用 Markdown。需要固定版式时选 PDF；需要评论、修订和 Office 编辑时选 DOCX；需要网页发布时选 HTML。不要为了交付而丢掉原 .md，它仍然是最容易修改和版本比较的来源。

转换前先预览表格、任务列表、图片、代码围栏和换行。转换后再在目标软件中检查一次，因为 PDF 的分页、Word 的字体和 HTML 的样式都可能与编辑器预览不同。

MD、TXT 和 HTML 有什么区别

三者都可以包含文字，但用途不同。TXT 没有通用排版语法；Markdown 用人容易读懂的符号表达常见结构；HTML 使用标签描述网页文档，并能配合 CSS 和脚本。

进一步阅读

想确认语法边界时，优先查看规范和目标应用的官方文档。

• CommonMark 规范
• GitHub Flavored Markdown 规范
• GitHub 写作与格式设置文档
• VS Code Markdown 文档

相关工具