跳到内容

Markdown 文件创建

编写 Markdown 并下载 .md。Front Matter / 表格 / 代码块 / 列表 / 标题快捷键,实时预览,模板。

完全免费 无需注册 浏览器内完成 即刻下载 5 种语言 深色模式
AI 编码助手 (Claude Code / Codex / Cursor) 请用: AGENTS.md / CLAUDE.md 生成器 →
模板: | 插入: ⬇ .md
0 字符 / 0 词 / 0

📖 常见的坑

编写 Markdown 并下载为 .md 文件,并提供 Front Matter 模板,可当场生成静态站点或 AI 编码助手的配置文件。此处的预览按基础 Markdown 渲染;表格、脚注、复选框的表现取决于发布目标是 GitHub、Hugo 还是 Notion。

情形 会发生什么 怎么处理
Front Matter 未被识别 YAML 对格式要求严格且会静默失败。三大常见原因是:用制表符缩进、: 之后缺少空格、值中含 : 却未加引号。分隔符 --- 还必须是文件的第一行,前面只要有空行或 BOM,该块就会被当成正文中的水平线。 缩进统一使用两个半角空格,标题这类自由输入的值务必用 "…" 包裹。日期请写成 2026-07-262026/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. 1
    选择模板
    从 README / Blog / ADR / Changelog / Docs 中选择
  2. 2
    编辑 + 预览
    左侧编辑,右侧 GFM 预览。插入按钮一键添加表格 / 代码 / 链接
  3. 3
    下载 .md
    改名后点击 "⬇ .md" 保存

❓ 常见问题

支持 Front Matter?
Blog 模板包含 YAML Front Matter
GitHub 风格?
GFM 兼容。表格 / 任务列表 / 删除线 / 自动链接
隐私?
完全在浏览器内
🐛 此工具出现问题了吗?

免费、无需注册。仅提供复现步骤也有帮助。报告将直接发送给运营者并用于改进。

※ 为复现问题,浏览器信息 (UA / 屏幕 / 语言 / URL) 将自动发送