How to make vite ignore `<docs>` blocks?

@muriel.schmidt 

To make Vite ignore <docs> blocks, you can use the vite-plugin-mdx plugin which allows you to configure how Vite treats Markdown files. With this plugin, you can specify certain attributes or elements to be ignored by Vite.

Here's an example configuration that ignores <docs> blocks in Markdown files:

1. Install the vite-plugin-mdx plugin:

1

npm install vite-plugin-mdx --save-dev

1. Add the plugin to your Vite configuration (usually vite.config.js):

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18

import { defineConfig } from 'vite'
import mdx from 'vite-plugin-mdx'

export default defineConfig({
  plugins: [
    mdx({
      // Custom MDX configuration
      remarkPlugins: [
        // Ignore <docs> blocks
        () => {
          return (tree) => {
            tree.children = tree.children.filter(node => node.type !== 'element' || node.tagName !== 'docs')
          }
        }
      ]
    })
  ]
})

With this configuration, Vite will ignore any <docs> blocks in Markdown files when processing them. You can customize the remarkPlugins array to add more custom parsing rules for your Markdown files.