one-sentence-per-line

Reformat index.qmd to place each sentence on its own line.

Updated Mar 7, 2025
One-click install
npx skills add https://github.com/quarcs-lab/project2025s --skill one-sentence-per-line
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: one-sentence-per-line
Source: https://github.com/quarcs-lab/project2025s/tree/main/.claude/skills/one-sentence-per-line
Command: npx skills add https://github.com/quarcs-lab/project2025s --skill one-sentence-per-line

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill reformats index.qmd to ensure each sentence starts on its own line, simplifying diffs and collaborative editing.

Core Features & Use Cases

  • Enforces one-sentence-per-line in index.qmd while preserving content and structure.
  • Detects and respects protected zones such as YAML frontmatter, code blocks, math blocks, and figure/table captions.
  • Ideal for manuscripts, notes, and any Markdown-based documents that benefit from consistent sentence-level formatting.

Quick Start

Run the formatter on the project’s index.qmd to reformat every sentence so it starts on its own line.

Frequently Asked Questions about one-sentence-per-line

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I format a Quarto manuscript so there is one sentence per line?

To format a Quarto manuscript with one sentence per line, run the formatter on your project's index.qmd. It adjusts line breaks so each sentence starts on its own line, which simplifies diffs and collaborative editing while preserving your document's content and structure.

Why use one sentence per line formatting in markdown for version control?

One sentence per line formatting in markdown helps version control by making line-level diffs correspond to sentence-level changes. This makes collaborative editing cleaner, as modifications to individual sentences appear as distinct line changes rather than large reformatted text blocks.

Does the one-sentence-per-line formatter preserve YAML frontmatter and code blocks?

Yes, the one-sentence-per-line formatter preserves YAML frontmatter, code blocks, math blocks, and figure or table captions. It detects and respects these protected zones, adjusting line breaks only in the standard manuscript text outside of them.

Can I reformat markdown documents other than index.qmd for collaborative editing?

The formatter's primary scope is the project's index.qmd file, but it is ideal for academic manuscripts and similar markdown-based documents used in collaborative editing. It enforces consistent sentence-level formatting across these markdown documents.

What is the best way to simplify diffs when collaboratively editing a manuscript?

The best way to simplify diffs when collaboratively editing a manuscript is to enforce one-sentence-per-line formatting. By placing each sentence on its own line, text changes map directly to line changes, making version control history much easier to review.

What happens to math blocks and captions when reformatting index.qmd?

When reformatting index.qmd, math blocks and captions are detected as protected zones and left untouched. The formatter strictly preserves these elements while adjusting line breaks only in the standard manuscript text.