# Configuration - content & AI Generated from the live plugin tables (`_VOID_TOKEN_MAP`, `_void_defaults`, the `_VOID_DEFAULT_*` dicts and the compiled token defaults in `void.scss`) by `tools/emit_config_reference.py`. The page is regenerated in CI and can never drift from the shipped code. ## content - [content.admonitions.enabled](#themevoidcontentadmonitionsenabled) · [content.admonitions.types.danger.color](#themevoidcontentadmonitionstypesdangercolor) · [content.admonitions.types.danger.icon](#themevoidcontentadmonitionstypesdangericon) · [content.admonitions.types.info.color](#themevoidcontentadmonitionstypesinfocolor) · [content.admonitions.types.info.icon](#themevoidcontentadmonitionstypesinfoicon) · [content.admonitions.types.note.color](#themevoidcontentadmonitionstypesnotecolor) · [content.admonitions.types.note.icon](#themevoidcontentadmonitionstypesnoteicon) · [content.admonitions.types.success.color](#themevoidcontentadmonitionstypessuccesscolor) · [content.admonitions.types.success.icon](#themevoidcontentadmonitionstypessuccessicon) · [content.admonitions.types.tip.color](#themevoidcontentadmonitionstypestipcolor) · [content.admonitions.types.tip.icon](#themevoidcontentadmonitionstypestipicon) · [content.admonitions.types.warning.color](#themevoidcontentadmonitionstypeswarningcolor) · [content.admonitions.types.warning.icon](#themevoidcontentadmonitionstypeswarningicon) · [content.back_to_top_label](#themevoidcontentback_to_top_label) · [content.back_to_top_threshold](#themevoidcontentback_to_top_threshold) · [content.code.annotate](#themevoidcontentcodeannotate) · [content.code.copied_label](#themevoidcontentcodecopied_label) · [content.code.copy_label](#themevoidcontentcodecopy_label) · [content.code.highlight_lines](#themevoidcontentcodehighlight_lines) · [content.code.line_number_color](#themevoidcontentcodeline_number_color) · [content.code.line_number_start](#themevoidcontentcodeline_number_start) · [content.code.show_copy_button](#themevoidcontentcodeshow_copy_button) · [content.code.show_line_numbers](#themevoidcontentcodeshow_line_numbers) · [content.glass](#themevoidcontentglass) · [content.max_width](#themevoidcontentmax_width) · [content.padding](#themevoidcontentpadding) · [content.progress_bar_color](#themevoidcontentprogress_bar_color) · [content.show_back_to_top](#themevoidcontentshow_back_to_top) · [content.show_progress_bar](#themevoidcontentshow_progress_bar) · [content.tables.bordered](#themevoidcontenttablesbordered) · [content.tables.responsive](#themevoidcontenttablesresponsive) · [content.tables.striped](#themevoidcontenttablesstriped) · [content.task_lists.custom_checkbox](#themevoidcontenttask_listscustom_checkbox) · [content.task_lists.enabled](#themevoidcontenttask_listsenabled) · [content.task_lists.persist_state](#themevoidcontenttask_listspersist_state) · [content.typography.anchor_symbol](#themevoidcontenttypographyanchor_symbol) · [content.typography.heading_anchor](#themevoidcontenttypographyheading_anchor) · [content.typography.image_behavior](#themevoidcontenttypographyimage_behavior) · [content.typography.image_lightbox](#themevoidcontenttypographyimage_lightbox) · [content.typography.link_behavior](#themevoidcontenttypographylink_behavior) · [content.typography.video_behavior](#themevoidcontenttypographyvideo_behavior) ### `theme.void.content.admonitions.enabled` | | | |---|---| | Default | `true` | ### `theme.void.content.admonitions.types.danger.color` | | | |---|---| | Default | `""` | ### `theme.void.content.admonitions.types.danger.icon` | | | |---|---| | Default | `""` | ### `theme.void.content.admonitions.types.info.color` | | | |---|---| | Default | `""` | ### `theme.void.content.admonitions.types.info.icon` | | | |---|---| | Default | `""` | ### `theme.void.content.admonitions.types.note.color` | | | |---|---| | Default | `""` | ### `theme.void.content.admonitions.types.note.icon` | | | |---|---| | Default | `""` | ### `theme.void.content.admonitions.types.success.color` | | | |---|---| | Default | `""` | ### `theme.void.content.admonitions.types.success.icon` | | | |---|---| | Default | `""` | ### `theme.void.content.admonitions.types.tip.color` | | | |---|---| | Default | `""` | ### `theme.void.content.admonitions.types.tip.icon` | | | |---|---| | Default | `""` | ### `theme.void.content.admonitions.types.warning.color` | | | |---|---| | Default | `""` | ### `theme.void.content.admonitions.types.warning.icon` | | | |---|---| | Default | `""` | ### `theme.void.content.back_to_top_label` | | | |---|---| | Default | `"Back to top"` | ### `theme.void.content.back_to_top_threshold` | | | |---|---| | Default | `500` | ### `theme.void.content.code.annotate` | | | |---|---| | Default | `true` | ### `theme.void.content.code.copied_label` | | | |---|---| | Default | `""` | ### `theme.void.content.code.copy_label` | | | |---|---| | Default | `""` | ### `theme.void.content.code.highlight_lines` | | | |---|---| | Default | `true` | ### `theme.void.content.code.line_number_color` | | | |---|---| | Default | `""` | ### `theme.void.content.code.line_number_start` | | | |---|---| | Default | `1` | ### `theme.void.content.code.show_copy_button` | | | |---|---| | Default | `true` | ### `theme.void.content.code.show_line_numbers` | | | |---|---| | Default | `false` | ### `theme.void.content.glass` | | | |---|---| | Default | `false` | ### `theme.void.content.max_width` | | | |---|---| | Default | `""` | ### `theme.void.content.padding` | | | |---|---| | Default | `""` | ### `theme.void.content.progress_bar_color` | | | |---|---| | Default | `""` | ### `theme.void.content.show_back_to_top` | | | |---|---| | Default | `true` | ### `theme.void.content.show_progress_bar` | | | |---|---| | Default | `true` | | Purpose | Toggles the top-edge reading progress bar. | | Example | `content: {show_progress_bar: true}` | ### `theme.void.content.tables.bordered` | | | |---|---| | Default | `false` | ### `theme.void.content.tables.responsive` | | | |---|---| | Default | `true` | ### `theme.void.content.tables.striped` | | | |---|---| | Default | `false` | ### `theme.void.content.task_lists.custom_checkbox` | | | |---|---| | Default | `true` | ### `theme.void.content.task_lists.enabled` | | | |---|---| | Default | `true` | ### `theme.void.content.task_lists.persist_state` | | | |---|---| | Default | `true` | ### `theme.void.content.typography.anchor_symbol` | | | |---|---| | Default | `""` | ### `theme.void.content.typography.heading_anchor` | | | |---|---| | Default | `true` | ### `theme.void.content.typography.image_behavior` | | | |---|---| | Default | `"normal"` | ### `theme.void.content.typography.image_lightbox` | | | |---|---| | Default | `true` | | Purpose | Toggles click-to-zoom image preview in the article. | | Example | `content: {typography: {image_lightbox: true}}` | ### `theme.void.content.typography.link_behavior` | | | |---|---| | Default | `"smooth"` | ### `theme.void.content.typography.video_behavior` | | | |---|---| | Default | `"responsive"` | ## config_builder - [config_builder.cluster_action](#themevoidconfig_buildercluster_action) · [config_builder.enabled](#themevoidconfig_builderenabled) · [config_builder.open_target](#themevoidconfig_builderopen_target) · [config_builder.toc_footer](#themevoidconfig_buildertoc_footer) · [config_builder.url](#themevoidconfig_builderurl) ### `theme.void.config_builder.cluster_action` | | | |---|---| | Default | `true` | ### `theme.void.config_builder.enabled` | | | |---|---| | Default | `false` | | Purpose | Dev tool that generates mkdocs.yml from a guided form. Ships OFF on purpose. | | Example | `config_builder: {enabled: false, url: assets/config-builder.html}` | ### `theme.void.config_builder.open_target` | | | |---|---| | Default | `"_blank"` | ### `theme.void.config_builder.toc_footer` | | | |---|---| | Default | `true` | ### `theme.void.config_builder.url` | | | |---|---| | Default | `"assets/config-builder.html"` | ## ai_reader - [ai_reader.auto_title](#themevoidai_readerauto_title) · [ai_reader.description](#themevoidai_readerdescription) · [ai_reader.enabled](#themevoidai_readerenabled) · [ai_reader.exclude](#themevoidai_readerexclude) · [ai_reader.llms](#themevoidai_readerllms) · [ai_reader.llms_full](#themevoidai_readerllms_full) · [ai_reader.markup](#themevoidai_readermarkup) · [ai_reader.overwrite](#themevoidai_readeroverwrite) · [ai_reader.sitemap](#themevoidai_readersitemap) · [ai_reader.url_style](#themevoidai_readerurl_style) · [ai_reader.watermark.enabled](#themevoidai_readerwatermarkenabled) · [ai_reader.watermark.footer](#themevoidai_readerwatermarkfooter) · [ai_reader.watermark.header](#themevoidai_readerwatermarkheader) · [ai_reader.watermark.include_generated](#themevoidai_readerwatermarkinclude_generated) · [ai_reader.watermark.include_site](#themevoidai_readerwatermarkinclude_site) · [ai_reader.watermark.include_url](#themevoidai_readerwatermarkinclude_url) · [ai_reader.watermark.include_version](#themevoidai_readerwatermarkinclude_version) · [ai_reader.watermark.text](#themevoidai_readerwatermarktext) ### `theme.void.ai_reader.auto_title` | | | |---|---| | Default | `true` | ### `theme.void.ai_reader.description` | | | |---|---| | Default | `""` | ### `theme.void.ai_reader.enabled` | | | |---|---| | Default | `true` | | Purpose | Master switch for the watermarked markdown mirrors AI agents can fetch. | | Example | `ai_reader: {enabled: true}` | ### `theme.void.ai_reader.exclude` | | | |---|---| | Default | `[]` | ### `theme.void.ai_reader.llms` | | | |---|---| | Default | `true` | ### `theme.void.ai_reader.llms_full` | | | |---|---| | Default | `true` | ### `theme.void.ai_reader.markup` | | | |---|---| | Default | `true` | ### `theme.void.ai_reader.overwrite` | | | |---|---| | Default | `false` | ### `theme.void.ai_reader.sitemap` | | | |---|---| | Default | `true` | ### `theme.void.ai_reader.url_style` | | | |---|---| | Default | `"sidecar"` | ### `theme.void.ai_reader.watermark.enabled` | | | |---|---| | Default | `true` | ### `theme.void.ai_reader.watermark.footer` | | | |---|---| | Default | `true` | ### `theme.void.ai_reader.watermark.header` | | | |---|---| | Default | `true` | ### `theme.void.ai_reader.watermark.include_generated` | | | |---|---| | Default | `true` | ### `theme.void.ai_reader.watermark.include_site` | | | |---|---| | Default | `true` | ### `theme.void.ai_reader.watermark.include_url` | | | |---|---| | Default | `true` | ### `theme.void.ai_reader.watermark.include_version` | | | |---|---| | Default | `true` | ### `theme.void.ai_reader.watermark.text` | | | |---|---| | Default | `"Generated by Void for AI agents."` |