Table Style Tweaks
rix443 downloadsCustomize table styles: minimum column width before wrapping, break tables out of readable line width, center or align tables, and scroll wide tables horizontally.
- Overview
- Scorecard
- Updates2
An Obsidian plugin that makes wide tables pleasant to read — without touching your readable line width.
Features
- Minimum column width — table cells stay on one line until their content reaches a configurable number of characters (default: 8). No more tables crushed into narrow, heavily wrapped columns.
- Break out of readable line width — tables may use the full view width while paragraphs stay within the readable line width. Best of both worlds.
- Maximum table width — cap how wide tables may grow (30–100% of the available width); content wraps beyond the cap. Adjust with a slider and watch tables resize live.
- Table alignment — center (default), left-align, right-align, or stretch tables to the full available width.
- Horizontal scrolling that actually works — when a table is wider than the view, it gets its own scrollbar that always reaches the very first and very last column. Headers and body never misalign (native table rendering is preserved).
- Slider + manual input — numeric settings offer both a slider and a synced text field; out-of-range typing is ignored until complete.
- Bilingual UI — the settings page follows Obsidian's display language (English / 简体中文).
- Works in both Reading view and Live Preview; all settings apply instantly.
Settings
| Setting | Type | Default |
|---|---|---|
| Minimum column width | Slider (4–40 characters) | 8 |
| Maximum table width | Slider (30–100%) | 100% |
| Break out of readable line width | Toggle | On |
| Table alignment | Center / Left / Right / Stretch | Center |
How it works
The plugin is intentionally minimal: it ships a small stylesheet (gated behind body classes) and sets Obsidian's official --table-column-min-width CSS variable. It does not re-render your tables, so header/body alignment is always guaranteed by the browser's native table layout. Disabling or uninstalling the plugin removes every trace of its styling.
Installation
From the community plugin store
Settings → Community plugins → Browse → search for Table Style Tweaks.
Via BRAT
- Install the BRAT plugin.
- Add the beta plugin with this repository's URL.
Manual
Copy main.js, manifest.json, and styles.css from the latest release into <your-vault>/.obsidian/plugins/table-style-tweaks/, then enable the plugin in Settings → Community plugins.
Compatibility
- Requires Obsidian 1.8.7 or newer.
- Desktop only:
isDesktopOnlyis set totruebecause the breakout behavior has not been verified on mobile yet.