Disabling MD022 for First-Level Headings

[Idobenhamo]

Hi,
Any chance that the rule MD022 can be disabled specifically for first-level headings?

Thanks in advance!

[rvben]

Hi @Idobenhamo,

I see that markdownlint has support for this, so I don't see a reason to support it in the same way.

[rvben]

Hi @Idobenhamo, you can now disable MD022 for first-level headings specifically using per-level configuration.

Here's how to configure it in your rumdl.toml:

[MD022]
# Disable blank line requirement above first-level headings (level 1)
# Keep normal requirements for levels 2-6
lines-above = [-1, 1, 1, 1, 1, 1]
lines-below = [1, 1, 1, 1, 1, 1]  # Keep normal requirement below all headings

The array format [-1, 1, 1, 1, 1, 1] corresponds to heading levels 1 through 6:

• -1 means unlimited (no requirement) for level 1 headings
• 1 means 1 blank line required for levels 2-6

If you also want to disable the blank line requirement below first-level headings, you can set:

[MD022]
lines-above = [-1, 1, 1, 1, 1, 1]
lines-below = [-1, 1, 1, 1, 1, 1]  # Also disable below for level 1

(This feature was added in version 0.0.180 and should match markdownlint's behavior.)

Let me know if it works as expected! Thanks for the suggestion 👍

[Idobenhamo]

Amazing thank you!

[Idobenhamo]

I just noticed the docs for MD022 are not updated with this new update😅
@rvben Thanks again!

[rvben]

Ah, thanks for the reminder, it's always a challenge to keep docs up-to-date 😀

[Idobenhamo]

Sorry for all of my questions, but how I can disable the formatting of wiki links? [[Example]] turn into Link Text]

[rvben]

Sorry for all of my questions, but how I can disable the formatting of wiki links? [[Example]] turn into Link Text]

You pointed me to a bug that I fixed for 0.0.182. Is it working properly now? Wiki links should be properly recognized.

[Idobenhamo]

Sorry for all of my questions and thanks again for your amazing work! I searched the docs but couldn't find it. Any chance that the creation of cache folders could be disabled? @rvben

[rvben]

@Idobenhamo, thanks for asking. The --no-cache CLI flag prevents cache folder creation entirely:

rumdl check --no-cache /path/to/files

When --no-cache is used:

• No .rumdl_cache directory is created
• All cache operations (init, get, set) are skipped
• Files are re-checked every time

[rvben]

I had thought about adding a config option too, like this:

.rumdl.toml

[global]
cache = false

pyproject.toml

[tool.rumdl]
cache = false

I plan to add this for next release.

[Idobenhamo]

Amazing thanks!
Any chance that you know how I can configure the formatter on helix without making cache folder?
This is my current config for the formatter:

formatter = { command = "rumdl", args = ["fmt", "-", "--quiet"] }

[rvben]

I would suspect this would work:

formatter = { command = "rumdl", args = ["fmt", "-", "--quiet", "--no-cache"] }

From 0.0.192 onwards, putting this in the .rumdl.toml config is probably clearest:

[global]
cache = false

[rvben]

Anyway, can you explain me why you would want to caching, @Idobenhamo? It helps me if I understand the use cases for it.