Does TOC generation support usage of custom rehype/remark plugins?

[SheezZarR]

Hii! I am working on a feature which adds an ability to conditionally render content. Initially I have gone the custom component route but it has failed. The hidden headings appear in the TOC component.

I have decided to write a custom Remark plugin. An example of my latest iteration of the feature

// MyMarkdownfile.md
# blah-blah-blah
sub-blah-blah

\```<process.env.VARIABLE1>-<process.env.VARIBALE2>
Content which should be visible if variable1 and variable2 are set. 

## some heading
<CustomComponent>some text here</CustomComponent>

\```

rest of the content...

I am able to get the value attribute of the type: 'code' node, which contains the actuall content to display. However, the tree I get after using remark.parse() is not insert-able because of an error "Cause: Cannot handle unknown node raw". Mdx components are transformed into type: 'html'.

Should I change my plans and do something else or it is possible to do remark.parse(content, some_docusaurus_options)?

Something similar to my request #9187 but in my case the people, who work on the document, want to edit only a single document and not many. And the generating environment is not really dynamic per se

[SheezZarR]

Hmm... I have tried making remark/rehype version of the same plugin (replaced code block with react component and looked at them) but the TOC still uses something entirely different for its operations.

I guess my main issue is the TOC which gets used in the documents. Cant find a reasonable solution to that. Updated the title of the discussion

EDIT:
The problem is - even after adding the remark plugin the TOC still displays removed heading. Why is that?

[slorber]

I don't really understand what problems you encounter, but you can implement conditional rendering of content with remark, and yes that affects the TOC. This means you can build the same site into multiple variants based on an env variable for example.

Here's a POC where the same site is built for regular users and admins: #10250

[SheezZarR]

@slorber yeah sorry. Question is a mess... I have updated the comment after the post. You have pointed in the right direction with #10250, thanks!

I mistakenly put the plugin in remarkPlugins instead of before... 😅

[SheezZarR]

Horahh... Finaly got back on the task. The stuff works with before... awesome