Skip to content

Commit 688b8d3

Browse files
authored
fix: extension defaults not additive (#59)
Signed-off-by: alexvoss <alex@corealization.com>
1 parent 3864a05 commit 688b8d3

1 file changed

Lines changed: 9 additions & 0 deletions

File tree

docs/setup/extensions/index.md

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -83,6 +83,8 @@ most of the features listed in the [Authoring] part of this documentation.
8383

8484
[Authoring]: ../../authoring/markdown.md
8585

86+
If you define other extensions or need to change options on any of the default
87+
extensions, you will need to configure _all_ of the extensions you are using.
8688
The following is the full expansion of the default configuration that you
8789
can use as a starting point if you want to explicitly control what Markdown
8890
extensions are active in your project:
@@ -161,6 +163,13 @@ extensions are active in your project:
161163
from Python Markdown itself. If you experience problems building your
162164
project, turn off the defaults, as shown below.
163165

166+
!!! note "Presets are on the roadmap"
167+
We are working on a [preset mechanism] that simplifies configuration and
168+
will allow you to add extensions to a set of defaults, customize extensions
169+
included in the defaults, as well as remove them.
170+
171+
[preset mechanism]: https://zensical.org/about/roadmap/#configuration
172+
164173
### Disable the defaults
165174

166175
If you want to reset the behavior to the default behavior of MkDocs, create a

0 commit comments

Comments
 (0)