# [`@stephansama`](https://github.com/stephansama) remark-asciinema
[](https://github.com/stephansama/packages/tree/main/core/remark-asciinema)
[](https://packages.stephansama.info/api/@stephansama/remark-asciinema)
[](https://www.npmx.dev/package/@stephansama/remark-asciinema)
[](https://socket.dev/npm/package/@stephansama/remark-asciinema/overview)
[](https://jsr.io/@stephansama/remark-asciinema)
[](https://www.npmx.dev/package/@stephansama/remark-asciinema)
[](https://npmx.dev/package/remark)
[](https://npmx.dev/package/tsdown)
A [remark](https://github.com/remarkjs/remark) plugin that transforms asciinema links into either an embedded [asciinema](https://docs.asciinema.org/manual/player/) player or screenshot that links to the recording.
## Features
- 🪄 Automatically converts asciinema links into:
- `
```
## Installation
```bash
pnpm install @stephansama/remark-asciinema
```
## Usage
```javascript
import { remark } from "remark";
import asciinema from "@stephansama/remark-asciinema";
export async function pipeline() {
const file = await remark()
.use(asciinema, { embedType: "script" })
.process("Check out: https://asciinema.org/a/abc123");
console.info(String(file));
}
```
## Additional notes
**Note**: After integrating the Remark plugin, ensure you include the necessary asciinema JavaScript and CSS files to enable proper playback and styling. You can load them via [UNPKG](https://unpkg.com/):
-
-