Markdown 写作指南:从入门到排版自如

目录

Markdown 让你专注于内容而不是排版。写博客、写 README、写笔记,一套语法全搞定。

常用语法速查

效果 语法
标题 # 一级 ## 二级 ### 三级
加粗 **加粗**
斜体 *斜体*
链接 [文字](https://example.com)
行内代码 `code`
引用 > 引用内容

代码块

def hello(name):
    print(f"Hello, {name}!")

列表

无序列表用 -,有序列表用 1. 2. 3.,嵌套缩进即可。

排版小技巧

  1. 每段只表达一个意思,短段落比长段落更好读
  2. 列表和表格能大幅提升可读性
  3. 插入分隔线用 ---,注意和标题语法区分
  4. 中文排版习惯:中英文之间加一个空格,比如 使用 Hugo 写博客

进阶

  • 图床 / 图片引用
  • 数学公式(KaTeX / MathJax)
  • Mermaid 流程图

需要的时候再学,Markdown 的核心就是:简单到让你忘记格式