With the paste role/directive introduced in b46c2f1 we also have the opportunity to exert a lot of control over the output. I could envisage creating a sphinx domain, e.g.

```{paste:literal} key1
```

```{paste:figure} key2
:name: label

A caption...
```

```{paste:subfig}
- key3
- key4
```

Originally posted by @chrisjsewell in #66 (comment)