remark-code-example

Remark plugin to copy live code block as code example

Downloads in past

Stats

StarsIssuesVersionUpdatedCreatedSize
remark-code-example
100.5.46 months ago2 years agoMinified + gzip package size for remark-code-example in KB

Readme

remark-code-example
Remark plugin to copy live code block as code example.
!npmnpm-badgenpm-url !githubgithub-badgegithub-url !nodenode-badge

Installation

npm install remark remark-code-example --save-dev

Usage

import readFileSync from 'node:fs';

import { remark } from 'remark';
import { remarkCodeExample } from 'remark-code-example';

const markdownText = readFileSync('example.md', 'utf8');

remark()
  .use(remarkCodeSample, {})
  .process(markdownText)
  .then((file) => console.info(file))
  .catch((error) => console.warn(error));

Options.metas

  • type: object of string
  • default: {}
  • required: false
  • description: Metas of example code block

Syntax

code-example

`````markdown Turn
```mermaid code-example flowchart Start --> Stop
Into

````markdown
```mermaid
flowchart
  Start --> Stop
``` ````

code-example-copy

`````markdown Turn
```mermaid code-example-copy flowchart Start --> Stop
Into

```mermaid
flowchart
  Start --> Stop

````markdown
flowchart
  Start --> Stop
``` ````

code-alias-copy

````markdown Turn
```mermaid code-alias-copy=diagram flowchart Start --> Stop
Into

```mermaid
flowchart
  Start --> Stop

flowchart
  Start --> Stop
````

Related