Markdown入门指南:从零开始写你的第一篇文档

AuthorMarch 8, 20241 min read

什么是Markdown?

Markdown是一种轻量级标记语言,由John Gruber于2004年创建。它的设计目标是让人们在写文档时,能够使用易读易写的纯文本格式,然后将其转换为结构化的HTML文档。今天,Markdown已经被广泛应用于GitHub、Stack Overflow、Reddit等平台,成为技术文档的事实标准。

基础语法速览

标题

使用 # 号标记标题,数量代表层级:

  • # 一级标题 — 相当于 h1
  • ## 二级标题 — 相当于 h2
  • ### 三级标题 — 相当于 h3

文本强调

  • **加粗** — 显示为加粗
  • *斜体* — 显示为斜体
  • ~~删除线~~ — 显示为删除线
  • `代码` — 显示为代码

链接格式:[显示文字](URL),例如 [Google](https://google.com)

图片格式:![替代文字](图片URL),与链接类似,前面多一个感叹号。

代码块

使用三个反引号包裹代码,并可以指定语言以获得语法高亮:

```javascript
function hello() {
  console.log("Hello, Markdown!");
}
```

列表

无序列表使用 -*+,有序列表使用数字加点:

  • 无序项目一
  • 无序项目二
  1. 有序项目一
  2. 有序项目二

表格

使用竖线和横线创建表格:

| 列1 | 列2 | 列3 |
|-----|-----|-----|
| 数据 | 数据 | 数据 |

进阶技巧

脚注

Markdown支持脚注:这是一段文字[^1],然后在文档底部 [^1]: 这是脚注内容

任务列表

GitHub风格的Markdown支持交互式任务列表:

  • - [x] 已完成的任务
  • - [ ] 未完成的任务

推荐工具

入门可以先用在线编辑器如Dillinger或StackEdit,进阶推荐使用VS Code配合Markdown插件,专业写作推荐Typora或Obsidian。

总结

Markdown的学习曲线非常平缓,掌握基本语法只需10分钟。但它能带来的效率提升是长期的。无论你是程序员还是写作者,Markdown都是值得投入时间学习的技能。

Recommended

Try our Word Counter

Try our professional online tool now. Completely free, no registration required.

Try it now
Share this article

Author

Experienced content creator, dedicated to sharing practical online tools and tutorials.

View all articles

Comments coming soon

Stay tuned