📝
WritingJava

Markdown Formatter

by liferay

Markdown Formatter is a Writing skill for Claude Code, published by liferay in liferay-portal.

2.3K stars3.8K forkson liferay/liferay-portalAdded 2026/07/20Repository updated 2026/08/03
View source on GitHubDownload repo ZIP
Install in seconds
Install Markdown Formatter
Copy Markdown Formatter into your Claude Code skills folder. Run the command in your terminal, or review the source on GitHub before installing.
terminal
npx degit https://github.com/liferay/liferay-portal/tree/master/.claude/skills/markdown-format ~/.claude/skills/markdown-format

Requires Node.js. Downloads this skill only — not the rest of the repository — into your Claude Code skills folder.

Without Node.js

git clone https://github.com/liferay/liferay-portal.git

Clones the whole repository, then copy the skill’s own directory into your skills folder yourself.

In this catalog

Source file
.claude/skills/markdown-format/SKILL.md in liferay/liferay-portal
Installs to
~/.claude/skills/markdown-format
Collection
One of 16 skills cataloged from this repository
Category
Writing — 1361 skills

What Markdown Formatter does

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.

Markdown Formatter is cataloged under Writing on DirSkills.

Documentation

README

Markdown Formatter

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

This is the opening of the README. Read the full README on GitHub.

Frequently asked about Markdown Formatter

  • What else does liferay publish alongside Markdown Formatter?

    Markdown Formatter is one of 16 skills that DirSkills catalogs from liferay/liferay-portal, the repository it ships in. Its siblings there include Create Pull Request, Format Source and Format Source Add Rule. Each one is a separate skill with its own page in this directory, installs the same way Markdown Formatter does, and is maintained by liferay in that same repository. The rest of the collection is listed on the liferay/liferay-portal page.

  • How does Markdown Formatter compare to other Writing skills?

    Markdown Formatter ranks #269 by stars among the 1361 Writing skills in this catalog. The most-starred ones next to it are Article Writing, Social Media Content Calendar and Knowledge Comic Creator. DirSkills ranks by the star count of the repository each skill ships in, so that order reflects how popular those repositories are rather than any review of Markdown Formatter against them. Open each page to compare what they document and how they install.

More from liferay/liferay-portal

Markdown Formatter is one of 16 skills cataloged on DirSkills from liferay/liferay-portal.

See all 16 skills →
🔀
2026/07/20

Create Pull Request

Creates a pull request for the current branch, ensuring tests are added, running pre-checks, and linking and transitioning Jira tickets. Use when submitting code for review.
Automation
2.3K3.8K
🧹
2026/07/20

Format Source

Automatically format Java, JavaScript, and other source files to comply with Liferay's coding standards using built-in formatters and manual rules.
Quality
2.3K3.8K
📝
2026/07/20

Format Source Add Rule

Encode a formatting convention spotted in a Git commit into a reusable rule for the format-source skill. Use this to systematically add formatting rules for Java, properties, XML, and more.
Quality
2.3K3.8K
🐛
2026/07/20

Jira Bug

Create a Jira bug ticket in the LPD project through the REST API. Use when the user asks to create or file a Jira bug or LPD ticket.
Automation
2.3K3.8K
🎫
2026/07/20

Jira Task

Creates a Jira task in the LPD project via REST API, inferring details from commit hashes or descriptions. Use when you need to create a Jira task or LPD ticket.
Automation
2.3K3.8K
🎨
2026/07/14

Liferay Portal Theme Design

Provides guidance on building and customizing themes and visual designs for Liferay Portal, including CSS, templates, and frontend assets.
Frontend
2.3K3.8K

More Writing skills

Markdown Formatter is one of 1361 Writing skills cataloged on DirSkills, ranked #269 by stars among them.

Browse all Writing skills →
✍️
4w ago

Article Writing

Article Writing writes articles, guides, blog posts, tutorials, newsletter issues, and other long-form content in a distinctive voice derived from supplied examples or brand guidance. Use it when you want polished written content longer than a paragraph, especially when voice consistency, structure, and credibility matter.
Writing
239.8K36.4K
📅
4w ago

Social Media Content Calendar

Social Media Content Calendar plans multi-platform social campaigns from briefs through scheduling and verified publishing. Use it when building a calendar, turning launches into posts, or repurposing content across X, LinkedIn, Instagram, and TikTok.
Writing
229.7K45.3K
🎨
4w ago

Knowledge Comic Creator

Knowledge Comic Creator generates educational, biography, and tutorial comics from user-provided text, URLs, or topics, with configurable art styles, tones, layouts, and languages. Use it when a user asks for a knowledge comic, 知识漫画, or Logicomix-style explanation.
Writing
229.7K45.3K