Tables¶
Tables are styled out of the box by the theme. Standard Markdown (PHP-Markdown style) tables, as well as raw <table> elements, get the glass treatment: a distinct header row, uppercase monospace header labels, row hover highlighting, and a responsive scroll wrapper.
Note
This styling is built into the theme — no configuration is required. Markdown tables render automatically.
Markdown Tables¶
The simplest way to create a table is with Markdown:
| Feature | Status | Notes |
|---|---|---|
| Admonitions | Done | Full Material family + icons |
| Tabs | Done | Keyboard navigable, unlimited |
| Task Lists | Done | Persisted to localStorage |
| Mermaid Diagrams | Done | Themed dark/light rendering |
| Feature | Status | Notes |
|-------------------|-------------|-------------------------------|
| Admonitions | Done | Full Material family + icons |
| Tabs | Done | Keyboard navigable, unlimited |
| Task Lists | Done | Persisted to localStorage |
| Mermaid Diagrams | Done | Themed dark/light rendering |
Aligned Columns¶
Markdown supports left, center, and right column alignment via the separator row:
| Left | Center | Right |
|---|---|---|
| Alpha | Beta | 100% |
| Gamma | Delta | 50% |
| Left | Center | Right |
|:--------------|:---------------:|------:|
| Alpha | Beta | 100% |
| Gamma | Delta | 50% |
Hover Interaction¶
Rows highlight on hover and the header is a distinct glass band:
| Package | Version | Python |
|---|---|---|
| mkdocs | 1.6 | >=3.8 |
| pymdownx | 10.9 | >=3.8 |
| highlight.js | 11.9 | n/a |
HTML Tables with Classes¶
For more control, use a raw HTML table and add the void-table class (and optionally wrap it in a void-table__wrap for responsive scrolling):
| Keyboard | Action |
|---|---|
| Ctrl+Shift+N | Toggle the Notes panel |
| Ctrl+Shift+B | Toggle the navigation sidebar |
<div class="void-table__wrap">
<table class="void-table">
<thead>
<tr><th>Keyboard</th><th>Action</th></tr>
</thead>
<tbody>
<tr><td>Ctrl+Shift+N</td><td>Toggle the Notes panel</td></tr>
<tr><td>Ctrl+Shift+B</td><td>Toggle the navigation sidebar</td></tr>
</tbody>
</table>
</div>
Styling Notes¶
.void-table__wrap— adds a scrollable container so wide tables scroll horizontally on small screens.- Plain
<table>(Markdown output) is styled identically without needing any class. - Header cells use the theme's mono font and uppercase tracking for a consistent technical look.