跳转至

Markdown 入门

什么是 Markdown?

Markdown 是一种轻量级标记语言,可通过简洁的语法对纯文本进行格式化。Markdown 文件使用 .md扩展名,并能轻松转换为 HTML 或其他格式。其格式直观易读,特别适合需要兼顾机器处理与人工编写的文档场景。

为何用Markdown实现文档即代码?

在实现文档即代码(docs-as-code)时,Markdown的优势尤为突出:

  • 协作友好性: 同时满足技术人员与非技术人员的读写需求。
  • 开箱即用的工具链支持: 全面兼容主流平台(GitHub、GitLab等)及静态站点生成器。
  • 低门槛: 相比复杂排版工具,Markdown更易上手。

Markdown核心语法精要

以下是基础格式规范示例:

# 一级标题
## 二级标题
### 三级标题

**加粗文本** or __加粗__
*斜体文本* or _斜体_

- 无序标题
- 使用连字符

1.  有序标题
2.  使用数字

[链接文本](https://example.com)

![替换文本](image.jpg)

`内联代码` 

了解更多

通过以下这些资源帮助你更好掌握 Markdown::
🔗 The Markdown 指南 - 交互式教程与速查表
🔗 CommonMark 规范 - 官方语法标准化文档