> ## Documentation Index
> Fetch the complete documentation index at: https://dotnetdocs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# IDocRenderer

> Defines a renderer for documentation output generation.

## Definition

**Assembly:** CloudNimble.DotNetDocs.Core.dll

**Namespace:** CloudNimble.DotNetDocs.Core

## Syntax

```csharp theme={"dark"}
CloudNimble.DotNetDocs.Core.IDocRenderer
```

## Summary

Defines a renderer for documentation output generation.

## Remarks

Implementations of this interface generate specific output formats (Markdown, JSON, YAML, etc.)
from the documentation model after all transformations have been applied.

## Methods

### <Icon icon="function" iconType="duotone" color="#419AC5" size={24} className="mr-2" /> RenderAsync <Badge color="orange">Abstract</Badge>

Renders the documentation assembly to the output path specified in the project context.

#### Syntax

```csharp theme={"dark"}
System.Threading.Tasks.Task RenderAsync(CloudNimble.DotNetDocs.Core.DocAssembly model)
```

#### Parameters

| Name    | Type                                       | Description                                                                |
| ------- | ------------------------------------------ | -------------------------------------------------------------------------- |
| `model` | `CloudNimble.DotNetDocs.Core.DocAssembly?` | The documentation assembly to render, or null for documentation-only mode. |

#### Returns

Type: `System.Threading.Tasks.Task`
A task representing the asynchronous rendering operation.

#### Remarks

When model is null, the renderer should skip API reference generation but still process
any other operations like navigation file merging (e.g., combining DocumentationReferences).

Renderers that support navigation combining (e.g., Mintlify) should access
Context.DocumentationReferences and combine navigation before saving their configuration.

### <Icon icon="function" iconType="duotone" color="#419AC5" size={24} className="mr-2" /> RenderPlaceholdersAsync <Badge color="orange">Abstract</Badge>

Renders placeholder conceptual content files for the documentation assembly.

#### Syntax

```csharp theme={"dark"}
System.Threading.Tasks.Task RenderPlaceholdersAsync(CloudNimble.DotNetDocs.Core.DocAssembly model)
```

#### Parameters

| Name    | Type                                      | Description                                              |
| ------- | ----------------------------------------- | -------------------------------------------------------- |
| `model` | `CloudNimble.DotNetDocs.Core.DocAssembly` | The documentation assembly to generate placeholders for. |

#### Returns

Type: `System.Threading.Tasks.Task`
A task representing the asynchronous placeholder rendering operation.