📝 Markdown 美观示例文档

本文档展示 Markdown 核心语法的规范使用，兼顾可读性与视觉美感，适用于文章、文档、笔记等场景。

一、基础排版

1.1 标题层级

  • 一级标题：# 标题（最多 1 个，作为文档标题）
  • 二级标题：## 标题（章节划分）
  • 三级标题：### 标题（小节细分）
  • 四级标题：#### 标题（补充说明，按需使用）

1.2 文本样式

样式 语法 效果示例
加粗 **加粗文本** 或 __加粗__ 这是加粗文本
斜体 *斜体文本* 或 _斜体_ 这是斜体文本
加粗斜体 ***加粗斜体*** 这是加粗斜体文本
删除线 ~~删除线文本~~ 这是删除线文本
下划线 <u>下划线文本</u> 这是下划线文本
代码片段 `单行代码` print("Hello Markdown")

1.3 引用

一级引用（常用）：Markdown 是一种轻量级标记语言，易读易写。

二级引用（嵌套）：支持嵌套引用，只需多添加一个 >

三级引用（深层嵌套）：可无限嵌套，按需使用

引用内支持 加粗、斜体、代码 等样式

  • 引用内可放列表
  1. 也可放有序列表
  • 核心功能
    • 文本排版
    • 代码展示
      • 单行代码
      • 多行代码块
  • 扩展功能
    • 图片插入
    • 表格制作
  1. 准备工作
    1. 安装 Markdown 编辑器（如 Typora）
    2. 新建 .md 文件
  2. 编写内容
    1. 添加标题
    2. 补充文本样式
  3. 预览与导出
    1. 实时预览效果
    2. 导出为 PDF/HTML
  • 完成 Markdown 基础语法学习
  • 掌握列表/表格/引用用法
  • 学习高级功能（公式/脚注）
  • 实战编写一篇文档
    • 插入图片
    • 添加代

Markdown 卡片

这是 HTML 嵌入 Markdown 的示例

Markdown 图标

本地示例图片

Markdown 官网

Markdown 官方指南

Halo 开源博客框架

跳转到「表格用法」

联系我

拨打客服

工具名称 适用场景 推荐指数 支持平台
Typora 本地文档编辑 ⭐⭐⭐⭐⭐ Windows/Mac/Linux
VS Code 代码+文档一体化 ⭐⭐⭐⭐ 全平台
Halo 内置编辑器 在线博客写作 ⭐⭐⭐⭐⭐ 网页端
Notion 知识库/协作编辑 ⭐⭐⭐⭐ 全平台
微信公众号编辑器 公众号推文 ⭐⭐⭐ 网页端
左对齐 居中对齐 右对齐
文本1 文本2 文本3
长文本示例 居中示例 数字1000

这是需要补充说明的正文内容^1，脚注会显示在文档底部。 另一处需要注释的内容^2，支持多个脚注。

（行尾加2个空格即可换行），也可包含 代码、加粗 等样式。

点击展开查看 Markdown 排版规范（必看）

  1. 标题与内容之间空 1 行，提升可读性

  2. 列表、引用、代码块前后空 1 行，避免拥挤

  3. 表格列数控制在 ≤5 列，避免横向滚动

  4. 图片添加 alt 文本，代码块指定语言

  5. 避免过度使用加粗/高亮，突出重点即可

  6. 多级标题层级连续（不跳过级别，如一级→三级）

123123123

默认展开的折叠块（添加 open 属性）

这是默认展开的内容，适合常用说明、补充资料等。

常用表情：😀 😊 👍 👎 🚀 ⭐ 📝 📌 ⚠️ ❌ ✅ 代码格式：:emoji名称:（如 :smile: → 😄，:rocket: → 🚀）