Semantic Line Breaks
4 days ago
- #formatting
- #markup
- #writing
- Semantic Line Breaks (SemBr) are conventions for structuring prose in markup languages without affecting rendered output.
- They involve adding line breaks after substantial units of thought, like sentences or clauses, to improve readability in source text.
- Supported by lightweight markup languages like Markdown, reStructuredText, and AsciiDoc.
- Key rules include not altering rendered output, breaking after sentences, and optionally after clauses or before lists.
- Benefits include easier editing, clearer source structure, and no impact on final output for readers.
- Common use cases involve technical writing, Git diffs, and migrating existing content incrementally.
- The specification is inspired by Semantic Versioning and community best practices.