定位中...

论坛Markdown编辑器使用方法

置顶
头像
admin 2025-06-24 20:48 已编辑
站务公告 260 浏览 4 回复
# 📘 Markdown 完全指南

> 10分钟掌握所有核心语法 · 通用所有平台  
> 支持 GitHub/知乎/Notion/VSCode/语雀等

---

## 🧱 基础语法

### 1. 标题
```markdown
# 一级标题 (H1)
## 二级标题 (H2)
### 三级标题 (H3)
#### 四级标题 (H4)

2. 文字样式

**粗体文本**  
*斜体文本*  
~~删除线文本~~  
==高亮文本== (部分平台)  
`行内代码`

3. 列表

- 无序列表 (使用 - 或 *)
  - 子列表 (缩进2空格)
  
1. 有序列表
2. 自动编号

4. 链接与图片

[显示文本](https://链接地址)
![图片描述](图片URL地址)
<https://自动识别链接>

⚙️ 高级功能

5. 代码块

```语言名称
# 支持语法高亮
print("Hello Markdown")
```

6. 表格

| 左对齐 | 居中对齐 | 右对齐 |
| :----- | :------: | -----: |
| 单元格 |  单元格  | 单元格 |
| **粗** | *斜*     | ~~删~~ |

7. 引用与注释

> 引用文本
>> 嵌套引用

<!-- 这是HTML注释 -->

8. 任务列表

- [x] 已完成
- [ ] 未完成

🎨 扩展功能

9. 数学公式 (需平台支持)

$$ E = mc^2 $$

10. 流程图

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

11. 目录生成

[TOC]  <!-- 自动生成目录 -->

📋 速查表

功能 语法 效果示例
粗体 **文本** 文本
斜体 *文本* 文本
链接 [标题](URL) 示例
图片 ![描述](URL) 显示图片
代码块 ```lang<br>代码``` 语法高亮区
表格头 --- 列分隔线
引用 > 文本 > 引用文本
任务列表 - [ ] 任务 - [ ] 任务

🚀 最佳实践

  1. 多级标题构建文档结构

    # 主标题
    ## 章节
    ### 小节
    
  2. 列表+任务管理内容

    - [x] 完成基础语法
    - [ ] 学习高级功能
      - [ ] 表格制作
      - [ ] 流程图
    
  3. 代码块+注释展示技术内容

    ```python
    # 计算阶乘
    def factorial(n):
        return 1 if n == 0 else n * factorial(n-1)
    
    <!-- 递归实现 -->
    
    
  4. 表格+图标增强可读性

    | 状态 | 操作       |
    |------|------------|
    | ✅   | 已完成     |
    | ⚠️   | 需要注意   |
    | ❌   | 已取消     |
    

💡 实时练习区

尝试创建以下内容:

  1. 二级标题:## 练习标题
  2. 带粗体的有序列表:
    1. 第一项
    2. 第二项
  3. 插入链接:Markdown官网
  4. 创建简单表格:
    姓名 年龄
    张三 28
    李四 32

✅ 提示:复制本完整文档到 Typora/VSCode/Notion 等编辑器查看实时渲染效果


---

## 🌐 平台兼容说明

| 平台       | 特色支持               | 备注                     |
|------------|------------------------|--------------------------|
| **GitHub** | 任务列表、表格         | README.md 标准           |
| **Notion** | 所有扩展语法           | 支持Mermaid流程图        |
| **知乎**   | 基础语法               | 部分CSS样式不同          |
| **语雀**   | 数学公式、目录生成     | 企业级文档平台           |
| **Typora** | 实时预览、所有扩展语法 | 最佳本地编辑器 (推荐使用) |

> ⚠️ 注意:不同平台可能对高级语法支持不同,建议先在目标平台测试

使用说明:

  1. 完整复制:选中从 # 📘 Markdown 完全指南 开始到最后一个反引号的所有内容
  2. 保存文件:粘贴到文本编辑器,保存为 markdown-guide.md
  3. 查看效果
    • 在线:上传到 GitHub/Gitee
    • 本地:用 TyporaVSCode 打开
  4. 直接使用:文档中的示例代码块可直接复制到您的 Markdown 文件中使用

这个完整教程包含:

  • 所有核心语法(标题/列表/代码/表格等)
  • 可视化速查表
  • 平台兼容性指南
  • 实时练习区
  • 最佳实践示例

设计为开箱即用,无需任何修改即可作为学习资料或参考手册 🚀

回复 (4)

一念 #1楼
2025-06-25 14:50 已编辑

⚠️ 注意:不同平台可能对高级语法支持不同,建议先在目标平台测试

一念 #2楼
2025-06-25 14:52

好家伙

一念 #3楼
2025-06-25 16:10
pie
"Dogs" : 386
"Cats" : 85
"Rats" : 15
小花 #4楼
2025-07-01 15:14

😂

发表回复

论坛 分类 功能 我的