Markdown 文件创建
编写 Markdown 并下载 .md。Front Matter / 表格 / 代码块 / 列表 / 标题快捷键,实时预览,模板。
完全免费
无需注册
浏览器内完成
即刻下载
5 种语言
深色模式
AI 编码助手 (Claude Code / Codex / Cursor) 请用:
AGENTS.md / CLAUDE.md 生成器 →
0 字符 / 0 词 / 0 行
📖 常见的坑
编写 Markdown 并下载为 .md 文件,并提供 Front Matter 模板,可当场生成静态站点或 AI 编码助手的配置文件。此处的预览按基础 Markdown 渲染;表格、脚注、复选框的表现取决于发布目标是 GitHub、Hugo 还是 Notion。
| 情形 | 会发生什么 | 怎么处理 |
|---|---|---|
| Front Matter 未被识别 | YAML 对格式要求严格且会静默失败。三大常见原因是:用制表符缩进、: 之后缺少空格、值中含 : 却未加引号。分隔符 --- 还必须是文件的第一行,前面只要有空行或 BOM,该块就会被当成正文中的水平线。 |
缩进统一使用两个半角空格,标题这类自由输入的值务必用 "…" 包裹。日期请写成 2026-07-26;2026/07/26 会被当作字符串,导致排序错乱。写完后用任意 YAML 解析器过一遍最为可靠。 |
| 换了行却连成一行 | Markdown 会把单个换行当作空格。这就是源文中已经换行、渲染结果却接在上一行后面的原因。这是规范预期的行为,并非缺陷。 | 要另起段落请空一行。若只想在段落内换行,可在行尾加两个半角空格或写 <br>。但行尾空格会被编辑器「保存时删除末尾空白」的设置清掉,因此团队协作中 <br> 更稳妥。 |
| Git 差异显示为整文件变更 | 只改了一个字符却出现整文件差异,几乎都是换行符在 CRLF 与 LF 之间来回变化所致。Windows 编辑器保存为 CRLF,Linux 侧工具又改回 LF,文件就此来回横跳。文件为 UTF-8 with BOM 时也有类似症状:只有第一行出现莫名其妙的差异。 | 统一保存为 UTF-8(无 BOM)+ LF。在仓库根目录放置 .gitattributes 并写入 *.md text eol=lf,即可不受各人环境设置影响。已有文件的批量转换可使用换行符转换。 |
Markdown 没有唯一的规范。CommonMark 是共同基础,GitHub Flavored Markdown 在其之上增加了表格、删除线、任务列表、自动链接;Hugo、Jekyll、Obsidian、Notion 又各有私有语法,脚注、公式、提示框的写法互不兼容。无论本地预览多整齐,都请在实际发布的地方确认一次。尤其是「想在表格单元格内换行」「想在单元格内写代码」这类需求,正是各实现分道扬镳之处。
📖 使用方法
-
1
选择模板从 README / Blog / ADR / Changelog / Docs 中选择
-
2
编辑 + 预览左侧编辑,右侧 GFM 预览。插入按钮一键添加表格 / 代码 / 链接
-
3
下载 .md改名后点击 "⬇ .md" 保存
❓ 常见问题
支持 Front Matter?
Blog 模板包含 YAML Front Matter
GitHub 风格?
GFM 兼容。表格 / 任务列表 / 删除线 / 自动链接
隐私?
完全在浏览器内
🐛 此工具出现问题了吗?
免费、无需注册。仅提供复现步骤也有帮助。报告将直接发送给运营者并用于改进。
✅
感谢您的反馈!
已送达运营者,将用于改进工具。