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

作者2024年3月8日3 分钟阅读

什么是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都是值得投入时间学习的技能。

推荐

试试我们的在线字数统计工具

立即体验专业的在线工具,完全免费,无需注册。

立即使用
分享这篇文章

作者

资深内容创作者,致力于分享实用的在线工具和使用教程。

查看全部文章

相关文章

评论功能开发中

敬请期待