---
title: embed
description: "Create an embedded wiki reference."
---

# embed

Create an embedded wiki reference.

## Syntax

```knap
{{ value | embed }}
{{ value | embed:"Preview" }}
```

## Usage

- The optional parameter sets an alias for string and array values.
- For object values, keys are targets and values are aliases.

## Examples

### File

```json title="Data"
{
  "target": "diagram.png"
}
```

```knap title="Template"
{{ target | embed }}
```

```md title="Output"
![[diagram.png]]
```

### Alias

```json title="Data"
{
  "target": "Project Atlas"
}
```

```knap title="Template"
{{ target | embed:"Preview" }}
```

```md title="Output"
![[Project Atlas|Preview]]
```

### Array data

```json title="Data"
{
  "targets": [
    "one.md",
    "two.md"
  ]
}
```

```knap title="Template"
{{ targets | embed }}
```

```md title="Output"
["![[one.md]]","![[two.md]]"]
```

## Related filters

- [image](/filters/image)
- [wikilink](/filters/wikilink)