> Discover all available pages from the documentation index: https://mastra.zisheng.pro/ko/llms.txt

# M문서

MDocument 클래스는 RAG 응용 프로그램용 문서를 처리합니다. 주요 방법은 다음과 같습니다`.chunk()`그리고`.extractMetadata()`.

## 건설자

**docs** (`Array<{ text: string, metadata?: Record<string, any> }>`): 텍스트 콘텐츠와 선택적 메타데이터가 포함된 문서 청크 배열입니다.

**type** (`'text' | 'html' | 'markdown' | 'json' | 'latex'`): 문서 콘텐츠의 유형입니다.

## 정적 방법

### `fromText()`

일반 텍스트 콘텐츠로 문서를 만듭니다.

```typescript
static fromText(text: string, metadata?: Record<string, any>): MDocument
```

### `fromHTML()`

HTML 콘텐츠에서 문서를 만듭니다.

```typescript
static fromHTML(html: string, metadata?: Record<string, any>): MDocument
```

### `fromMarkdown()`

Markdown 콘텐츠에서 문서를 만듭니다.

```typescript
static fromMarkdown(markdown: string, metadata?: Record<string, any>): MDocument
```

### `fromJSON()`

JSON 콘텐츠에서 문서를 만듭니다.

```typescript
static fromJSON(json: string, metadata?: Record<string, any>): MDocument
```

## 인스턴스 메소드

### `chunk()`

문서를 청크로 분할하고 선택적으로 메타데이터를 추출합니다.

```typescript
async chunk(params?: ChunkParams): Promise<Chunk[]>
```

자세한 옵션은 [chunk() 레퍼런스](https://mastra.zisheng.pro/ko/reference/rag/chunk)를 참조하세요.

### `getDocs()`

처리된 문서 청크의 배열을 반환합니다.

```typescript
getDocs(): Chunk[]
```

### `getText()`

청크에서 텍스트 문자열의 배열을 반환합니다.

```typescript
getText(): string[]
```

### `getMetadata()`

청크에서 메타데이터 개체의 배열을 반환합니다.

```typescript
getMetadata(): Record<string, any>[]
```

### `extractMetadata()`

지정된 추출기를 사용하여 메타데이터를 추출합니다. 자세한 내용은 [ExtractParams 레퍼런스](https://mastra.zisheng.pro/ko/reference/rag/extract-params)를 참조하세요.

```typescript
async extractMetadata(params: ExtractParams): Promise<MDocument>
```

## 예

```typescript
import { MDocument } from '@mastra/rag'

// Create document from text
const doc = MDocument.fromText('Your content here')

// Split into chunks with metadata extraction
const chunks = await doc.chunk({
  strategy: 'markdown',
  headers: [
    ['#', 'title'],
    ['##', 'section'],
  ],
  extract: {
    summary: true, // Extract summaries with default settings
    keywords: true, // Extract keywords with default settings
  },
})

// Get processed chunks
const docs = doc.getDocs()
const texts = doc.getText()
const metadata = doc.getMetadata()
```