Markdown 文件怎么写？

Markdown（简称 MD）是一种轻量级标记语言，广泛用于写作说明文档、博客、README 文件等。它语法简洁，易于阅读和编写，同时可转换为 HTML 等格式。

一、基础语法速览

• 标题：使用 # 表示，例如：
  

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

• 段落与换行：段落之间空一行；行尾加两个空格可强制换行。
• 强调：
  • 斜体：*斜体* 或 _斜体_
  • 粗体：**粗体** 或 __粗体__
  • 删除线：~~删除线~~
• 列表：
  • 无序列表：用 -、* 或 +
    

    - 项目一
    - 项目二

  • 有序列表：用数字加点
    

    1. 第一项
    . 第二项

• 链接与图片：

  [百度](https://www.baidu.com)
  ![替代文字](图片地址.jpg)

• 代码：
  • 行内代码：`console.log('hello')
  • 代码块：用三个反引号包裹
    

    ```js
    console.log('Hello Markdown');
    ```

• 引用：以 > 开头
  

  > 这是一段引用内容。

• 分隔线：三个或以上 -、* 或 _
  

  ---

二、编写建议

1. 使用纯文本编辑器（如 VS Code、Notepad++、Typora）编写 .md 文件。
2. 文件扩展名为 .md 或 .markdown。
3. 保持结构清晰，善用标题层级。
4. 预览效果可使用在线工具或支持 Markdown 的编辑器。

三、常见用途

Markdown 广泛应用于：

• GitHub / GitLab 的 README.md
• 技术博客（如 Hexo、Hugo）
• 笔记软件（如 Obsidian、Notion）
• 文档协作平台