Markdown 写作指南:从入门到排版自如
目录
Markdown 让你专注于内容而不是排版。写博客、写 README、写笔记,一套语法全搞定。
常用语法速查
| 效果 | 语法 |
|---|---|
| 标题 | # 一级 ## 二级 ### 三级 |
| 加粗 | **加粗** |
| 斜体 | *斜体* |
| 链接 | [文字](https://example.com) |
| 行内代码 | `code` |
| 引用 | > 引用内容 |
代码块
def hello(name):
print(f"Hello, {name}!")
列表
无序列表用 -,有序列表用 1. 2. 3.,嵌套缩进即可。
排版小技巧
- 每段只表达一个意思,短段落比长段落更好读
- 列表和表格能大幅提升可读性
- 插入分隔线用
---,注意和标题语法区分 - 中文排版习惯:中英文之间加一个空格,比如
使用 Hugo 写博客
进阶
- 图床 / 图片引用
- 数学公式(KaTeX / MathJax)
- Mermaid 流程图
需要的时候再学,Markdown 的核心就是:简单到让你忘记格式。