-
-
Notifications
You must be signed in to change notification settings - Fork 1.4k
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
The remark config documentation misses some important information #8036
Comments
The markdown guide explains this (see Customizing a plugin. I did notice the reference is presented first in the search results, which I'm guessing is what lead you to reference? We could 100% look at adding a plugin with options or a link to the example. |
Yes, I ended up in the reference via search. An example plugin with options or a link to the existing example will make things a lot easier. |
Interestingly when I searched, I did not get reference first but did get the upgrade guides first, then the Learn, and then reference! What if we just update the example on the configuration reference page, which currently shows
We try to keep the configuration page as concise as possible, but this at least is a visual clue to point people in the right direction without needing a ton of words to clutter the page. Would be happy if someone would like to make a PR to that effect! The change to make would be on this line |
📋 Explain your issue
I wanted to add the remarkToc plugin to my astro config as described in the documentation.
However, I wanted to customize the
remarkToc
plugin instead of using the defaults. This information is missing in the docs. I had to first look look up the RemarkPlugins type in the repo before figuring out how to pass in the config object like so:I think it would be a good idea to explain the different ways of adding the plugins with custom config or linking to that explanation it if it has been explained somewhere else in the docs.
The text was updated successfully, but these errors were encountered: