掘金写文章Markdown功能代码速查手册

170 阅读2分钟

掘金Markdown功能代码速查手册

官方详细版
如何使用掘金社区 - 阴明 - 掘金小册

🎯 快捷键

  • 粗体: Ctrl/Cmd + B
  • 斜体: Ctrl/Cmd + I
  • 链接: Ctrl/Cmd + K
  • 图片: Ctrl/Cmd + Shift + I
  • 有序列表: Ctrl/Cmd + Shift + O
  • 无序列表: Ctrl/Cmd + Shift + U
  • 行内代码: Ctrl/Cmd + Shift + K
  • 代码块: Ctrl/Cmd + Shift + C

📝 基础语法

标题

# 一级标题
## 二级标题  
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题

文本样式

**粗体文本**
*斜体文本*
~~删除线文本~~

列表

# 无序列表
- 项目一
- 项目二
- 项目三

# 有序列表  
1. 项目一
2. 项目二
3. 项目三

# 任务列表
- [ ] 未完成任务
- [x] 已完成任务

链接和图片

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

# 图片
![图片描述](图片URL)

代码

# 行内代码
这是 `行内代码` 示例

# 代码块
```语言名
代码内容

### 表格
```markdown
| 列1 | 列2 | 列3 |
|:---:|----:|:----|
| 居中 | 右对齐 | 左对齐 |
| 内容1 | 内容2 | 内容3 |

分隔线

---
***
- - -

🧮 数学公式

行内公式

这是行内公式 $E=mc^2$ 

块级公式

$$
x = \frac{-b \pm \sqrt{b^2 - 4ac}}{2a}
$$

📊 Mermaid图表

流程图

```mermaid
graph TD
    A[开始] --> B[处理]
    B --> C[结束]
```

时序图

```mermaid
sequenceDiagram
    Alice->>Bob: 消息1
    Bob-->>Alice: 回复
```

甘特图

```mermaid
gantt
    title 项目计划
    dateFormat YYYY-MM-DD
    section 阶段1
    任务1: 2024-01-01, 30d
    任务2: after 任务1, 20d
```

饼状图

```mermaid
pie title 数据分布
    "A": 45
    "B": 30  
    "C": 25
```

类图

```mermaid
classDiagram
    Animal <|-- Dog
    Animal : +age
    Animal : +name()
    class Dog{
        +breed
        +bark()
    }
```

状态图

```mermaid
stateDiagram-v2
    [*] --> 状态1
    状态1 --> 状态2
    状态2 --> [*]
```

关系图

```mermaid
erDiagram
    CUSTOMER ||--o{ ORDER : places
    ORDER ||--|{ LINE-ITEM : contains
```

旅程图

```mermaid
journey
    title 用户旅程
    section 购买流程
    浏览商品: 5: 用户
    添加购物车: 3: 用户
    结算支付: 1: 用户
```

💡 高级功能

代码高亮

支持100+种语言,指定语言名即可:

```javascript
console.log('Hello World');
```

```python
print("Hello World")
```

```bash
echo "Hello World"
```

表格对齐

| 默认 | 左对齐 | 居中 | 右对齐 |
|------|:-------|:----:|-------:|
| 内容 | :---   | :---: | ---: |

🔧 实用技巧

快速插入

  • 拖拽图片直接插入
  • Cmd/Ctrl + V 粘贴图片
  • 自动保存草稿功能

编辑器切换

  • Markdown编辑器 ⇄ 富文本编辑器
  • ⚠️ 切换时注意备份内容

多屏编辑

  • 写作模式
  • 预览模式
  • 左右同步滚动

📋 常用模板

代码说明模板

## 功能说明
描述代码功能

## 代码实现
```language
代码内容

参数说明

参数类型说明
param1string参数说明