# Markdown Unwrap

> Unwraps hard-wrapped markdown files so that each sentence ends with a newline instead of mid-sentence line breaks. Joins continuation lines within a paragraph into single lines, then re-breaks at sentence boundaries (period, question mark, exclamation point). Preserves blank lines, headings, fenced code blocks, block quotes, and list items. Use when asked to unwrap text, fix line breaks, reflow s…

- **Type:** Skill
- **Install:** `agentstack add skill-christopherkenny-skills-markdown-unwrap`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [christopherkenny](https://agentstack.voostack.com/s/christopherkenny)
- **Installs:** 0
- **Category:** [Content & Media](https://agentstack.voostack.com/c/content-and-media)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [christopherkenny](https://github.com/christopherkenny)
- **Source:** https://github.com/christopherkenny/skills/tree/main/skills/markdown-unwrap

## Install

```sh
agentstack add skill-christopherkenny-skills-markdown-unwrap
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Markdown Unwrap

Reflow a markdown (or `.qmd`) file so that each **sentence** occupies its own line. This is the inverse of hard-wrapping: mid-sentence newlines are removed and the text is re-broken only at sentence endings.

## Input Arguments

| Position | Required | Description |
|----------|----------|-------------|
| 1 | **Yes** | Path to the input `.md` or `.qmd` file |
| 2 | No | Output path. Defaults to overwriting the input file in-place |

**Example invocations:**
```
/markdown-unwrap paper/paper.qmd
/markdown-unwrap README.md README-unwrapped.md
```

## Algorithm

Process the file line-by-line, maintaining a **current paragraph buffer**:

1. **Pass-through lines** — output immediately, do not buffer:
   - Blank lines (flush the buffer first, then emit the blank line)
   - ATX headings (`#`, `##`, …)
   - Fenced code block delimiters (` ``` ` or `~~~`); toggle a *in-code-block* flag and pass all lines through until the closing fence
   - Block-quote lines starting with `>`
   - List item lines starting with `-`, `*`, `+`, or a digit followed by `.`/`)`
   - YAML front-matter delimiters `---` / `...` (pass the entire front-matter block through unchanged)

2. **Buffering** — for all other lines, append the line's text to the current buffer (joining with a single space, trimming leading/trailing whitespace from each line).

3. **Flushing** — when a pass-through line (or end-of-file) is encountered, flush the buffer:
   - Split the accumulated text into sentences at `(?<=[.!?])\s+` — i.e., after a sentence-ending punctuation mark followed by whitespace.
   - Emit each sentence on its own line.
   - Clear the buffer.

4. Write the result to the output path (or overwrite the input if no output path was given).

## What Is Preserved

- Blank lines (paragraph separators)
- Fenced code blocks (contents unchanged)
- YAML front matter
- Headings, list items, and block quotes (each kept on its own line)
- All text content — only whitespace between words is affected

## What Changes

- Mid-sentence hard-wrap newlines are removed
- Each sentence ends with exactly one newline
- Trailing spaces within paragraphs are removed

## Implementation Notes

Implement the algorithm directly in your response — read the file, process it line-by-line following the rules above, and write the result. No external script is needed.

The sentence-split heuristic: a period followed by whitespace and an uppercase letter is a sentence boundary **unless** the word immediately before the period is a known abbreviation. Maintain a blocklist of common abbreviations that should never trigger a split:

- Titles: `Mr`, `Mrs`, `Ms`, `Dr`, `Prof`, `Sr`, `Jr`, `Rev`, `Gov`
- Latin: `e.g`, `i.e`, `et al`, `vs`, `etc`
- Academic: `Fig`, `Eq`, `Sec`, `Ch`, `Vol`, `No`, `pp`

When the token before the period matches one of these (case-insensitively), do not split. For `?` and `!` there is no abbreviation concern — always split.

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [christopherkenny](https://github.com/christopherkenny)
- **Source:** [christopherkenny/skills](https://github.com/christopherkenny/skills)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-christopherkenny-skills-markdown-unwrap
- Seller: https://agentstack.voostack.com/s/christopherkenny
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.