什么是Markdown
Markdown是一种轻量级标记语言,使用纯文本格式编写文档,通过简单的标记符号实现排版。它被广泛用于README、文档、博客等场景。
标题语法
使用#号表示标题,一个#是一级标题,两个##是二级标题,以此类推,最多六级。
文本格式
强调语法:一对星号是斜体,两对是粗体,三对是粗斜体;两个波浪号是删除线;反引号是行内代码。
列表与引用:无序列表用 - 或 *,有序列表用 数字加英文句点,嵌套缩进两个空格(或一个 Tab);引用用 > 开头,可多层嵌套。
链接与图片:链接是 [文字](地址),图片在前面多一个感叹号,支持鼠标悬停标题。
代码块
用三个反引号围栏包裹代码块,第一行末尾标注语言名可获得语法高亮;这是 Markdown 里使用频率最高的语法之一。
缩进式代码块:每行缩进 4 个空格也能形成代码块,但不支持语法高亮,现在更推荐围栏写法。
表格
表格用竖线分隔单元格,用第二行的连字符与冒号控制对齐方式:默认左对齐,:--: 居中,--: 右对齐。
使用技巧
转义字符:想显示 Markdown 语法本身(比如写教程),在符号前加反斜杠即可:\*、\#、\[。
任务列表:GFM 扩展语法,GitHub、语雀等平台都支持,适合写 TODO 和更新日志。
分隔线与脚注:三个以上的星号、连字符或下划线独占一行是分隔线;脚注用 [^1] 标注、文末补充说明,适合论文式写作。
最佳实践:① 标题层级不要跳级,一篇文档一个 h1;② 列表前后留空行,避免解析成普通段落;③ 复杂表格在编辑器里调,别手写对齐;④ 不同平台对语法的支持有差异(如 GFM 才支持表格和任务列表),跨平台发布前先预览。
本站的 Markdown 编辑器支持实时预览和一键复制,可以边写边对照效果。