skills.rest
lucasvtiradentes
lucasvtiradentesCOMMUNITY
Explore all skills by this author →
GitHub

align-docs

Fix alignment issues in markdown tables, ASCII diagrams, and lists using mdalign.

Updated Aug 23, 2026
Search Tags:#documentation#markdown#formatting#alignment#mdalign
One-click install
npx skills add https://github.com/lucasvtiradentes/lvt-spec --skill align-docs
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: align-docs
Source: https://github.com/lucasvtiradentes/lvt-spec/tree/main/.agents/skills/align-docs
Command: npx skills add https://github.com/lucasvtiradentes/lvt-spec --skill align-docs

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill automatically fixes alignment issues in markdown files, ensuring consistent formatting for tables, ASCII diagrams, and lists.

Core Features & Use Cases

  • Automated Markdown Alignment: Uses mdalign to check and fix formatting inconsistencies.
  • Targeted Fixing: Can process specific files or entire folders.
  • Use Case: When markdown tables or ASCII art look messy and unreadable, this skill can automatically clean them up.

Quick Start

Use the align-docs skill to fix markdown alignment in the 'docs/' folder.

Frequently Asked Questions about align-docs

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

FAQPage Schema
How do I fix markdown table alignment issues in my documentation?▼

To fix markdown table alignment issues, use an automated tool that checks for mdalign installation, corrects formatting inconsistencies, and auto-fixes alignment problems in markdown files.

Can I automatically format ASCII diagrams in markdown files?▼

Yes, you can automatically format ASCII diagrams in markdown files by invoking an alignment check that targets ASCII art, auto-fixing issues and guiding manual fixes for remaining problems.

What's the best way to correct formatting inconsistencies across an entire markdown folder?▼

The best way to correct formatting inconsistencies across a markdown folder is to process the entire directory with an alignment tool that auto-fixes tables and lists in bulk.

Does automated markdown alignment work for list formatting as well as tables?▼

Automated markdown alignment works for list formatting as well as tables by targeting lists specifically, checking for mdalign installation, and auto-fixing the detected formatting inconsistencies.

What should I do when auto-fixing markdown alignment leaves remaining formatting problems?▼

When auto-fixing markdown alignment leaves remaining formatting problems, the tool guides you through manual fixes for the specific alignment issues that could not be automatically corrected.

Related Skills

Explore More Software Engineering Skills→
i9wa4i9wa4
11

confluence-to-md

Convert Confluence pages to Markdown files with timestamps and page titles.

Community
Basic
KrystianYCSilvaKrystianYCSilva

markdown-expert

Create Markdown documentation with Mermaid diagrams and GFM tables.

Community
Intermediate
luanzebaluanzeba

mermaid

Validate Mermaid diagrams syntax in .mmd files and Markdown blocks, rendering SVG output with ASCII previews.

Community
Intermediate
Mahaboob26Mahaboob26

markdown-documentation

Create structured Markdown documentation with GitHub Flavored Markdown formatting.

Community
Basic