GH001

Error

The gh issue create command has markdown formatting issues in the issue body.

Why this matters

Properly formatted markdown renders correctly on GitHub and makes issues easier to read. Malformed tables, missing blank lines around headings, and other formatting issues can make issues hard to parse.

How to fix

Fix the markdown formatting issues reported in the error output:

gh issue create --title "Bug: login fails" --body "$(cat <<'EOF'
## Description

Login fails when using SSO authentication.

## Steps to reproduce

1. Navigate to login page
2. Click "SSO Login"
3. Enter credentials
4. Observe error

## Expected behavior

User should be redirected to dashboard.
EOF
)"

Or use a file:

gh issue create --title "Bug: login fails" --body-file issue-body.md

Configuration

[validators.github.issue]
enabled = true
timeout = "10s"
require_body = false
markdown_disabled_rules = ["MD013", "MD034", "MD041", "MD047"]

Hook output

When this error is triggered, klaudiush writes JSON to stdout:

permissionDecisionReason (shown to Claude): [GH001] Issue body markdown validation. Fix markdown formatting in issue body (empty lines around headings, proper list spacing)

systemMessage (shown to user): Formatted error with fix hint and reference URL.

additionalContext (behavioral guidance): Automated klaudiush validation check. Fix the reported errors and retry the same command.

Related

• GIT023 - PR validation failure
• FILE005 - markdown linting