> ISPO SDK documentation. [HTML](https://ispo.ai/docs/interfaces/core.DocumentsApi.html) · [Documentation index](https://ispo.ai/docs/llms.txt)

# Interface DocumentsApi

```typescript
interface DocumentsApi {
    toMarkdown(
        content: DocumentContent,
        options?: DocumentsToMarkdownOptions,
    ): Promise<DocumentsToMarkdownResult>;
    toMarkdown(
        args: DocumentsToMarkdownArgs,
    ): Promise<DocumentsToMarkdownResult>;
}
```

Types: [toMarkdown](#tomarkdown-1), [DocumentContent](../types/core.DocumentContent.md), [DocumentsToMarkdownOptions](core.DocumentsToMarkdownOptions.md), [DocumentsToMarkdownResult](core.DocumentsToMarkdownResult.md), [toMarkdown](#tomarkdown-2), [DocumentsToMarkdownArgs](core.DocumentsToMarkdownArgs.md)

##### Index

### <a id="methods"></a>Methods

[toMarkdown](#tomarkdown)

## <a id="methods-1"></a>Methods

### <a id="tomarkdown"></a>toMarkdown

*   <a id="tomarkdown-1"></a>
    
    ```typescript
    toMarkdown(
        content: DocumentContent,
        options?: DocumentsToMarkdownOptions,
    ): Promise<DocumentsToMarkdownResult>
    ```
    
    Types: [DocumentContent](../types/core.DocumentContent.md), [DocumentsToMarkdownOptions](core.DocumentsToMarkdownOptions.md), [DocumentsToMarkdownResult](core.DocumentsToMarkdownResult.md)
    
    Convert a binary document to GitHub-Flavored Markdown.
    
    This is a PURE TRANSFORM and needs no declaration and no grant: the bytes are ones the caller already holds, and the host reads no path and opens no store on its behalf. A document that cannot be converted rejects with a `documents-denied` `ProjectRpcError` whose message names the closed reason (`unsupported`, `encrypted`, `too-large`, `limit`, `timeout`, `unavailable`) — a refusal is typed data, never a silent empty string.
    
    #### Parameters
    
    *   content: [DocumentContent](../types/core.DocumentContent.md)
    *   `Optional`options: [DocumentsToMarkdownOptions](core.DocumentsToMarkdownOptions.md)
    
    #### Returns Promise<[DocumentsToMarkdownResult](core.DocumentsToMarkdownResult.md)\>
    
*   <a id="tomarkdown-2"></a>
    
    ```typescript
    toMarkdown(args: DocumentsToMarkdownArgs): Promise<DocumentsToMarkdownResult>
    ```
    
    Types: [DocumentsToMarkdownArgs](core.DocumentsToMarkdownArgs.md), [DocumentsToMarkdownResult](core.DocumentsToMarkdownResult.md)
    
    #### Parameters
    
    *   args: [DocumentsToMarkdownArgs](core.DocumentsToMarkdownArgs.md)
    
    #### Returns Promise<[DocumentsToMarkdownResult](core.DocumentsToMarkdownResult.md)\>