Markdown Formatter
SkillFiles & storageLets your agent reformat a Markdown file to match Liferay's style rules for headings, frontmatter, and CLI flags.
Available today. Use it from your connected AI after setup.
No other account needed.
Connect ahel once, and every AI you use reads what you have installed.
Then ask your AI: use the Markdown Formatter skill
About this capability
Format a Markdown file to match Liferay conventions — frontmatter order, Title Case headings, braced shell variables, long-form CLI flags, and professional prose. Use when the user asks to format, clean up, polish, or copy-edit a Markdown file destined for the Liferay repository.
What this skill tells your AI
The instructions your AI receives, as published by liferay/liferay-portal in .claude/skills/markdown-format/SKILL.md and read by ahel’s review.
Apply Liferay Markdown conventions to the target file so its structure, casing, and prose are consistent and professional.
Input
When ${ARGUMENTS} is a path to a Markdown file, format that file. When no path is supplied, ask the user which file to format.
Workflow
Read the File
Read the target file in full before making changes. Note the frontmatter, headings, code blocks, and any conventions already in use.
Apply the Conventions
Apply all conventions defined in .claude/rules/markdown-style.md. Work through each category in order. Fix each category before moving to the next.
Validate
Reread the file after the pass and confirm every check still holds.
Report
Summarize the changes, grouped by category (frontmatter, headings, prose, shell, lists).
Signals
- GitHub stars
- 2k
- Forks
- 4k
- Last commit
- Sep 2026
Advanced
- Catalog kind
- skill
- Gateway key
markdown-format- Source
- github.com/liferay/liferay-portal