Skip to content

better tables #316

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.

Sign up for GitHub

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

Open
nlopes wants to merge 14 commits into
base: main
Choose a base branch
from
Open

better tables #316

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
14 commits
Select commit Hold shift + click to select a range
bea2a3c
chore(tests): add table cell fixtures
nlopes Jan 17, 2026
e16cec0
feat(parser): add table colspand and rowspan
nlopes Jan 17, 2026
6b8bc94
feat(html): add table colspand and rowspan
nlopes Jan 17, 2026
2ecc6cb
feat(parser): complete cell specifier support for tables
nlopes Jan 17, 2026
440ccd9
feat(html): support table visual attributes
nlopes Jan 17, 2026
9cce853
fix(README): use all features and targets during nextest
nlopes Jan 17, 2026
2296b95
chore(parser): show line when include directive can't be processed
nlopes Jan 17, 2026
52b7e60
fix(parser): correct table cell content position tracking
nlopes Jan 17, 2026
22dd7c6
chore(parser): colspan/rowspan don't need to have a default serde
nlopes Jan 17, 2026
4673844
chore(parser): removed unnecessary pub functions
nlopes Jan 17, 2026
14405b3
fix(parser): DSV tables no longer drop the first cell
nlopes Jan 18, 2026
63f310e
fix(parser): accurate source positions for CSV multiline quoted values
nlopes Jan 18, 2026
f317146
chore(parser): detect unsupported counter and warn about it
nlopes Jan 18, 2026
cde88ce
chore(html): simplify captions + support disabling them
nlopes Jan 19, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
28 changes: 28 additions & 0 deletions CHANGELOG.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -38,6 +38,15 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0

### Added

- Table colspan and rowspan rendering (`colspan="n"` and `rowspan="n"` attributes on `<th>`/`<td>`)
- Table visual attribute support:
- `frame` attribute - controls outer border (`all`, `ends`/`topbot`, `sides`, `none`)
- `grid` attribute - controls inner gridlines (`all`, `rows`, `cols`, `none`)
- `stripes` attribute - controls row striping (`even`, `odd`, `all`, `hover`)
- `width` attribute - sets explicit table width (e.g., `width=75%`)
- `%autowidth` option - uses `fit-content` sizing instead of `stretch`
- Custom roles from metadata applied as CSS classes
- Cell-level alignment overrides are now respected, falling back to column-level defaults
- Initial support for `[subs=...]` attribute on verbatim blocks (listing, literal)
- `subs=none` - disables all substitutions, outputs raw content
- `subs=specialchars` - only escapes HTML special characters
Expand Down Expand Up @@ -80,6 +89,15 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0

### Added

- Complete cell specifier support for tables:
- Colspan: `2+|` spans 2 columns
- Rowspan: `.2+|` spans 2 rows
- Combined: `2.3+|` spans 2 columns and 3 rows
- Cell duplication: `3*|` duplicates cell content 3 times
- Cell-level horizontal alignment: `<|` (left), `^|` (center), `>|` (right)
- Cell-level vertical alignment: `.<|` (top), `.^|` (middle), `.>|` (bottom)
- Cell-level style: `s|` (strong), `e|` (emphasis), `m|` (monospace), etc.
- All specifiers can be combined (e.g., `2.3+^.^s|` for colspan=2, rowspan=3, centered, strong)
- Tag filtering for include directives ([#279])
- `tag=name` - include a specific tagged region
- `tags=a;b;c` - include multiple tags (semicolon or comma delimited)
Expand All @@ -98,6 +116,14 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0

### Fixed

- DSV tables now correctly preserve the first cell. Previously, DSV format (`cell1:cell2`)
was incorrectly treated like PSV (`| cell1 | cell2 |`), causing the first cell to be
dropped. Escape handling (`\:` → literal `:`) also works correctly now.
- Table cell content now has correct source position tracking for multi-line cells
- CSV tables with quoted multiline values now have accurate source positions. Previously,
positions were approximated without accounting for quote characters, so `"Hello\nWorld"`
would report incorrect line/column. Now positions point to actual content start (inside
the quotes), with proper handling for RFC 4180 escaped quotes (`""`).
- Description lists with terms starting with `#` (e.g., `#issue-123:: definition`)
are no longer incorrectly parsed as section boundaries inside sections. The
section boundary detection now requires a space after the level marker.
Expand All @@ -123,6 +149,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0

### Changed

- **BREAKING**: `TableColumn` struct now includes `colspan`, `rowspan`, `halign`, `valign`,
and `style` fields.
- **BREAKING**: `BlockMetadata.substitutions` changed from `Option<Vec<Substitution>>`
to `Option<SubstitutionSpec>`. New types `SubstitutionSpec` and `SubstitutionOp` are
now public exports. Modifier syntax (`+quotes`, `-callouts`) is now stored as operations
Expand Down
Loading
Loading