Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Appearance settings

[MegaLinter][valid] Markdown polish: markdownlint + markdown-table-formatter findings #3841

Copy link
Copy link

Description

@plengauer
Issue body actions

From the 2026-07-24 Analyze run. Classified as valid findings (bucket 1), all low-severity docs polish.

markdownlint (84 findings, by rule)

  • MD040 (fenced code block missing language) — by far the most common, across most demos/*/README.md files, CONTRIBUTING.md, .github/skills/*.md. Easy bulk fix, just needs a human to pick the right language tag per block (mostly bash/text/json from context).
  • MD013 (line length, limit 400) — README.md (10 occurrences) and demos/injection_deep_gradle/README.md (6), all on long inline example/config lines rather than prose. Given these docs use wide inline tables/examples, you may want to raise or disable the line-length limit for markdown specifically rather than reflow these lines — your call.
  • MD058 (tables need surrounding blank lines) — README.md, 4 occurrences, on the semantic-conventions tables.
  • MD041 (first line should be a top-level heading) — README.md, demos/README.md, .github/constant-instructions.md. Note README.md opens with an italic aside before its H1 (_(This repository is also available under the aliases ...)_), which reads like a deliberate pattern rather than an oversight — might be worth a per-file exception (front_matter_title/first_line_heading config) rather than moving that line.
  • MD034 (bare URL) — .github/workflows/monitor_changelog.md:33, 2 occurrences.
  • MD010 (hard tabs) — demos/injection_deep_python/README.md, 8 occurrences.
  • MD060 (table column spacing style) — .github/skills/ci-troubleshooting.md, 6 occurrences.
  • MD009 (trailing spaces) — README.md:351, 1 occurrence.

markdown-table-formatter

2 files need table reformatting: .github/skills/ci-troubleshooting.md, README.md — consistent with the MD058/MD060 findings above.

Reactions are currently unavailable

Metadata

Metadata

Labels

documentationImprovements or additions to documentationImprovements or additions to documentationgood first issueGood for newcomersGood for newcomers

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions

Morty Proxy This is a proxified and sanitized view of the page, visit original site.