zenn-markdownlint-config

Configure markdownlint-cli2 with Zenn-specific rule overrides for articles and books.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/shimo4228/claude-code-learned-skills --skill zenn-markdownlint-config
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: zenn-markdownlint-config
Source: https://github.com/shimo4228/claude-code-learned-skills/tree/main/skills/zenn-markdownlint-config
Command: npx skills add https://github.com/shimo4228/claude-code-learned-skills --skill zenn-markdownlint-config

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Zenn content repositories often trigger excessive markdownlint false positives. This Skill provides Zenn-specific rule overrides for markdownlint-cli2 to align linting with Zenn conventions and reduce noisy alerts.

Core Features & Use Cases

  • Zenn-aware overrides for common MD025, MD041, MD060, and MD013 behavior
  • JSONC configuration example (.markdownlint-cli2.jsonc) with allowed elements and exclusion rules
  • Works with articles and books in Zenn, enabling consistent style across the repository

Quick Start

Install and apply the Zenn-specific markdownlint-cli2 configuration to your repository to suppress false positives.

Frequently Asked Questions about zenn-markdownlint-config

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

FAQPage Schema
Why does markdownlint trigger false positives in Zenn repositories?

Markdownlint triggers false positives in Zenn repositories because standard rules conflict with Zenn-specific frontmatter and table formatting conventions. This configuration applies Zenn-aware overrides to suppress these noisy alerts.

How do I configure markdownlint-cli2 for Zenn articles and books?

To configure markdownlint-cli2 for Zenn, apply a JSONC configuration file with Zenn-specific rule overrides. This setup enables frontmatter-aware linting and table formatting allowances across your articles and books.

What markdownlint rules need overrides for Zenn content?

Common markdownlint rules needing overrides for Zenn content include MD025, MD041, MD060, and MD013. This configuration adjusts their behavior to align with Zenn conventions and reduce false positives.

Can I use markdownlint with frontmatter in Zenn markdown files?

Yes, you can use markdownlint with frontmatter in Zenn markdown files by applying this configuration. It enables frontmatter-aware overrides to ensure linting passes without triggering false alerts on article metadata.

Does this markdownlint configuration work for both Zenn articles and books?

Yes, this markdownlint configuration works for both Zenn articles and books. It targets setup and ongoing linting to ensure consistent style and reduce false positives across your entire Zenn content repository.

What is the best way to reduce markdownlint alerts in Zenn docs?

The best way to reduce markdownlint alerts in Zenn docs is to apply Zenn-specific configuration rules. This approach aligns linting with Zenn conventions, allowing specific elements and excluding noisy rule violations.