[v2] Alternative way for handling code tabs or add docs preprocessing hook

💥 Proposal

It would be nice to have an alternative way of defining code-tabs that doesn’t rely on MDX Tabs/TabItem. This is specially interesting for teams that don’t have MDX knowledge or that don’t want to use it (for portability, readability…).

E.g. if one or more code blocks are next to each other convert them into code-tabs:

    ```kotlin
    // Some code
    ```

    ```typescript
    // Some code
    ```

👆 In this case there should be a way also to map code-block language hint to tab name. e.g. typescript => TypeScript.

Alternatively, there could be a way to hook to the markdown loading step so that the developers could modify the markdown content programatically. e.g. search via regex and add the required Tabs/Tabitem code.

[load markdown] => [hook modifies markdown content] => [render]

Have you read the Contributing Guidelines on issues?

Yes.

[amimas]

Agree with @yangshun that it can be difficult to tell if code blocks should be grouped or tabbed. Someone else might want them as individual code blocks without tabs.

This feels like getting into the territory of markdown parser and that’s not what Docusaurus is for/does.

[yangshun]

E.g. if one or more code blocks are next to each other convert them into code-tabs

Hard to tell if code blocks should be grouped together. One possible way is to add in metadata into the first line to define the group.

But overall I’m not very keen on adding more syntax if MDX can do the job. If you’re going to have a new syntax, MDX can be that syntax. MDX is easy to use and is very expressive.