@mdit-vue/plugin-component

@mdit-vue/plugin-component

A markdown-it plugin to allow Vue components in markdown.

• Treat vue built-in components and unknown HTML tags as vue components (markdown-it would treat them as inline tags by default).
• Allow vue @ directive on native HTML tags.
• With full tests.

Install

npm i @mdit-vue/plugin-component

Usage

This plugin will only take effects when the html option of markdown-it is enabled:

import MarkdownIt from 'markdown-it';
import { componentPlugin } from '@mdit-vue/plugin-component';

const md = MarkdownIt({ html: true }).use(componentPlugin, {
  // options
});

const rendered = md.render(
  `\
<!-- @ shorthand is supported -->
<Foo @click="onClick" />

<!-- multi-line syntax won't be wrapped with <p> -->
<Foo
  class="foo"
  :bar="bar"
/>
`,
);

Options

blockTags

• Type: string[]

• Default: []

• Details:

  Extra tags to be treated as block tags.

  By default, all standard HTML inline elements will be treated as inline tags (excluding Vue built-in special elements).

  In some cases you might want to force some inline tags to behave like block tags. For example, when you create a Vue component with the same name as a standard HTML inline element (not recommended though).

  You can use this option to specify standard inline tags as block tags.

  Notice that this option is case-sensitive, and has higher priority than the inlineTags option.

inlineTags

• Type: string[]

• Default: []

• Details:

  Extra tags to be treated as inline tags.

  By default, only standard HTML inline elements will be treated as inline tags (excluding Vue built-in special elements).

  All other unknown elements will be treated as block tags, because we are assuming that they are custom Vue components.

  Treating Vue components as block tags would work as expected in most cases. However, in some edge cases, the behavior of block tags is not ideal with Vue components. For example, when using a HTML block tag at the beginning of a list item, the following Markdown syntax in the same list item will be invalid, but users might want an inline Vue component there.

  You can use this option to specify unknown tags as inline tags.

  Notice that this option is case-sensitive, and has lower priority than the blockTags option.

Changelog

0.8.0 (2022-07-22)

Features

• plugin-component: add blockTags and inlineTags options (4651422)