flowmark

Format Markdown with typography corrections and semantic line breaks.

75|8|Updated Feb 10, 2025
One-click install
npx skills add https://github.com/jlevy/flowmark --skill flowmark
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: flowmark
Source: https://github.com/jlevy/flowmark/tree/main/.agents/skills/flowmark
Command: npx skills add https://github.com/jlevy/flowmark --skill flowmark

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Flowmark formats Markdown with typography improvements, consistent line breaks, and diff-friendly output to simplify reviews.

Core Features & Use Cases

  • Typography cleanup (smart quotes, ellipses) and safe formatting that preserves code blocks.
  • Optional semantic line breaks for cleaner git diffs.
  • Use across CLI, editor integrations, and CI to normalize documents before commit.

Quick Start

Format Markdown files in place with flowmark using --auto to apply changes or pipe input for preview.

Frequently Asked Questions about flowmark

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

FAQPage Schema
How do I format Markdown documents to ensure smaller Git diffs?

You can format Markdown documents to ensure smaller Git diffs by applying semantic line breaks, typography corrections, and consistent wrapping. This normalizes text formatting and prevents unnecessary changes from appearing in version control commits.

What is the best way to clean up LLM-generated Markdown formatting?

Cleaning up LLM-generated Markdown formatting involves applying typography corrections like smart quotes and ellipses, adding semantic line breaks, and wrapping text. This process ensures typographic consistency and produces diff-friendly output for local repositories and CI pipelines.

How do I apply typography corrections to Markdown without breaking code blocks?

Applying typography corrections to Markdown without breaking code blocks requires safe formatting logic that preserves fenced code sections. This ensures smart quotes and ellipses are only applied to standard text while leaving code snippets untouched.

Does flowmark respect ignore files like .gitignore when formatting Markdown?

Yes, flowmark respects ignore files like .gitignore and .flowmarkignore during Markdown formatting. This allows you to exclude specific files or directories from typography cleanup and line break normalization in your repository.

Can I use Markdown formatting tools across both CLI and CI pipelines?

Yes, you can use Markdown formatting tools across CLI, editor integrations, and CI pipelines to normalize documents before commit. This ensures consistent typography and diff-friendly output across local editing workflows and automated documentation checks.

Why should I use semantic line breaks in my Markdown documentation?

Using semantic line breaks in Markdown documentation ensures cleaner Git diffs by placing logical breaks between sentences. This means future edits only affect specific lines rather than reflowing entire paragraphs, making code reviews much simpler.