MD041/first-line-h1 complains despite `title` attribute in frontmatter

Start of my .md file:

---
path: "/impressum"
date: "2012-06-21T10:14:00.000+02:00"
title: "Impressum"
---

## Angaben gemäß § 5 TMG

My .markdownlintrc file:

{
  "MD002": { "level": 2 },
  "MD041": { "level": 2 },
  //"MD041/first-line-h1": { "level": 2 }, <-- Tried that one too
  "MD026": { "punctuation": ".,;:" },
}

But still:

markdownlint -c ../../.markdownlintrc src/pages/imprint.md
src/pages/imprint.md: 7: MD041/first-line-h1 First line in file should be a top level header [Context: "## Angaben gemäß § 5 TMG"]

Am I missing sth or is this a bug?

[DavidAnson]

Okay, I’ve convinced myself the behavior of MD041 should change. If a YAML title property is present, this rule should accept that as the “top level heading” and not warn again no matter what’s in the body of the document. If it behaved that way, your configuration above would do what you want without any changes. If I still feel this way tomorrow, I’ll look at making this change. Thanks for calling this out!

[DavidAnson]

The code does respect YAML titles, but there’s a subtlety that’s causing this issue.

First, proof that YAML title is respected - the following does not trigger MD041:

---
path: "/impressum"
date: "2012-06-21T10:14:00.000+02:00"
title: "Impressum"
---

Hallo

## Angaben gemäß § 5 TMG

However, your example reports an issue because the first text of the document is a header. If MD041 sees a header first, it doesn’t care if a front matter title is present and it reports an issue.

I’ll think about whether that might be correct, but it seems wrong to me right now, so I’m calling this a bug and you can assume I will fix it in the next release.

Sorry about that!