---
tag: md-font
icon: font
title: 字体组件
---

设置整个文档的字体和文字颜色，支持 Google Fonts、emfont 和系统本地字体三种来源。

**语法：** `:md-font[字体名]{选项}`

**Google 字体：**
```markdown
:md-font[Noto Sans SC]{source="google"}
```

**Emfont 字体：**
```markdown
:md-font[Source Han Serif]{source="emfont" weight="700"}
```

**本地字体（默认）：**
```markdown
:md-font[STSong]
```

**设置文字颜色：**
```markdown
:md-font[Noto Sans SC]{source="google" color="#1a1a2e"}
:md-font[Noto Sans SC]{source="google" weight="700" color="crimson"}
```

字体和颜色将应用到整个文档卡片。

## 属性

| 属性 | 类型 | 默认值 | 说明 |
|---|---|---|---|
| `source` | `google` \| `emfont` \| `local` | `local` | 字体来源 |
| `weight` | string | `"400"` | 字体粗细 |
| `color` | string | — | 文字颜色（CSS 颜色值，如 `#ff00dd`、`rgb(255,0,0)`） |

## 使用场景

用于切换文档的显示字体和文字颜色，适配不同风格需求。