Skip to content

Conversation

@dereuromark
Copy link
Contributor

@dereuromark dereuromark commented Jan 14, 2026

Summary

Alternative implementation to #57 based on jgm's feedback in jgm/djot#368

Syntax

Uses a leading + prefix for continuation lines:

| Name | Description |
|------|-------------|
| Item | Long text   |
+      | continued   |

Why This Approach

jgm (djot creator) suggested:

"use a different delimiter at the beginning to signal that the contents of this line just get added to the cells... this one makes the table look more like a table"

This implementation uses + as the leading delimiter.

Features

  • Row-level continuation (+ prefix instead of |)
  • Support for multiple continuation lines
  • Works with row and cell attributes
  • Preserves alignment from separator row
  • Content merged with space (like soft breaks in paragraphs)
  • Inline formatting (emphasis, links, code spans) works in merged content
  • Multi-line captions already supported without special syntax

Edge Cases Tested

  • Code spans in continuation lines
  • Emphasis spanning continuation
  • Links split across continuation (parser handles gracefully)
  • Multi-line table captions

Related

Implements an alternative syntax for multi-line table cells based on
jgm's feedback in jgm/djot#368

Syntax: Lines starting with + continue the previous row's cell contents.

| Name | Description |
|------|-------------|
| Item | Long text   |
+      | continued   |

This approach makes the table look more like a table (per jgm's comment)
compared to trailing backslash syntax.

Features:
- Row-level continuation (+ prefix instead of |)
- Support for multiple continuation lines
- Works with row and cell attributes
- Preserves alignment from separator row
- Content merged with space (like soft breaks)
@codecov
Copy link

codecov bot commented Jan 14, 2026

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 93.51%. Comparing base (6c0ff92) to head (0df6a21).

Additional details and impacted files
@@             Coverage Diff              @@
##             master      #65      +/-   ##
============================================
+ Coverage     93.48%   93.51%   +0.03%     
- Complexity     1956     1966      +10     
============================================
  Files            74       74              
  Lines          5247     5276      +29     
============================================
+ Hits           4905     4934      +29     
  Misses          342      342              

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
  • 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

Tests added:
- Code spans with continuation (complete spans work)
- Multi-line table captions (already supported)
- Emphasis spanning continuation
- Strong emphasis in continuation
- Links split across continuation (parser handles gracefully)
- Complete links with continuation text

These tests address jgm's concerns from issue #368 about
code spans and captions spanning multiple lines.
@dereuromark
Copy link
Contributor Author

Closing in favor of #67

@dereuromark dereuromark deleted the feature/multiline-table-cells-plus-prefix branch January 16, 2026 09:26
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

extra beyond standard/specs RFC

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants