CtrlK
BlogDocsLog inGet started
Tessl Logo

pantheon-ai/markdown-authoring

Author high-quality Markdown documentation with deterministic structure, lint compliance, and CI integration. Use when writing README files, creating docs pages, fixing markdownlint failures, defining style rules, or wiring markdown checks into pre-commit and pipelines. Keywords: markdown, markdownlint, readme, docs, headings, lists, code fences, links, images, lint config, ci, documentation style.

95

1.00x
Quality

92%

Does it follow best practices?

Impact

97%

1.00x

Average score across 7 eval scenarios

SecuritybySnyk

Passed

No findings from the security scan

Overview
Quality
Evals
Security
Files

task.mdevals/scenario-1/

Fix Markdownlint Violations

A contributor submitted a documentation file with several markdownlint violations. The violations must be fixed in the source content. Disabling rules globally or adding broad suppressions is not acceptable.

Here is the input document (guide.md):

# Getting Started
### Installation

Run the following to install:

```
npm install my-tool
```

Then configure it:

```
# config.yaml
host: localhost
port: 8080
```

## Usage

- Use the `--verbose` flag for detailed output
* Use the `--dry-run` flag to preview changes
+ Use `--help` to see all options

#### Advanced Options

For power users, the following options are available:

| Option | Description |
|--------|-------------|
|`--timeout` | Sets the request timeout  |
| `--retries`| Number of retries |

Produce a corrected file guide.md that:

  1. Fixes the heading level skip (H1 → H3 skipping H2).
  2. Adds language tags to all untagged fenced code blocks.
  3. Makes list markers consistent throughout the document.
  4. Fixes the heading level skip from H2 to H4.
  5. Normalizes the table column spacing for consistency.
  6. Does not add any markdownlint disable comments or change the document's content meaning.

Produce a single file guide.md with all violations corrected.

SKILL.md

tile.json