Documentation only renders when there are at least two spaces at the end of .md file about mkdocs-click HOT 5 CLOSED

I also had this same issue on macOS 12.4, Python3.10 and mkdocs-click version 0.8.0.
Fixed it with a double newline at the end.

from mkdocs-click.

I think part of the issue is that h1 is set as the CLI's name. Can you try :depth: 1 or removing header?

from mkdocs-click.

Hey @ofek. Sure! Here are a few of the variations I've attempted based on your suggestion

• Changing the h1 label (just to test in this case), one space at the end of the file, with and without :depth: 1 tag
• Removing the header, one space at the end of the file, with and without :depth: 1 tag

None of those work, however, they all work if there are two spaces at the end of the file.

EDIT: I can also add, the issue was identical for me in two different environments, one arch linux and the other macOS.

Double edit: It also works with a newline + space or newline + tab.

from mkdocs-click.

I can confirm the issue.

I thought something was misconfigured, but then I found this issue and thought I'd try it out. For me a single newline with no extra characters fixes the problem.

from mkdocs-click.

I also ran into this issue, if it is required (it is really okay that it is) ideally there would be a check for this at build time (or a note in the README). I spent a fair amount of time banging my head against a wall to find out why I couldn't get my docs to generate.

Python 3.11, Ubuntu 22.04, mkdocs-click = "^0.8.0"

from mkdocs-click.