markdown编辑器

html代码预览

markdown使用指南

以下是一份详细的Markdown语法指南，综合了多个平台的最新规范与实践经验，涵盖基础语法、高级功能及兼容性说明：

---

一、基础语法

1. 标题与层级

用#符号定义1-6级标题，建议标题与内容间保留空格：

# 一级标题  
## 二级标题  
### 三级标题（最多支持六级）

适用场景：技术文档章节划分、微信公众号图文排版（微信仅支持二级标题）。

2. 段落与换行

• 段落分隔：通过空行实现
• 强制换行：行尾添加两个空格或\符号

3. 文本强调

效果	语法	示例
斜体	*文本* 或 _文本_	示例
粗体	**文本**	示例
粗斜体	***文本***	示例
删除线	~~文本~~	示例
高亮	<mark>文本</mark>	示例
*注：部分平台需HTML标签实现高亮和下划线。

---

二、结构化内容

1. 列表

• 无序列表：使用-、*或+

  - 一级列表
    - 二级列表（缩进2空格）
  

• 有序列表：数字+.自动编号

  1. 第一步
  2. 第二步
     1. 子步骤
  

2. 引用与注释

• 引用块：>符号起始，支持多级嵌套

  > 主要观点
  >> 补充说明
  

• 脚注：

  正文内容
  : 脚注说明
  

3. 表格

用|分隔列，-定义表头对齐方式：

| 左对齐 | 居中对齐 | 右对齐 |
|:-------|:--------:|-------:|
| 数据1  | 数据2    | 100    |

提示：Typora等编辑器支持可视化表格编辑。

---

三、代码与公式

1. 代码块

• 行内代码：反引号包裹 `printf()`
• 语法高亮：指定语言类型

  def hello():
      print("Hello Markdown!")
  

2. 数学公式

• 行内公式：$E=mc^2$ → $E=mc^2$
• 独立公式：

  $$
  \nabla \times \vec{\mathbf{B}} = \frac{\partial \vec{\mathbf{E}}}{\partial t}
  $$
  

兼容性：需编辑器支持LaTeX渲染。

---

四、扩展功能

1. 流程图与图表（需Mermaid支持）

graph TD
A[开始] --> B{条件判断}
B -->|是| C[执行操作]
B -->|否| D[结束]

2. GFM扩展语法

• 任务列表：- [x] 已完成任务
• 自动链接：直接输入URL或邮箱<contact@example.com>

3. HTML混合

支持嵌入HTML标签实现复杂排版：

<span style="color:red">红色警告文本</span>

---

五、工具与适配建议

1. 编辑器推荐：Typora（实时预览）、VS Code（插件扩展）
2. 平台兼容：微信图床需用公众号图片、避免SVG格式
3. 格式转换：使用Pandoc将MD转为PDF/Word

---

更多细节可参考：CommonMark规范 、GFM扩展文档

---

本文整合自多个权威来源，覆盖2025年主流平台的Markdown实现标准。如需特定场景（如学术论文）的深度应用，建议结合Zotero等文献管理工具扩展使用