mark icon indicating copy to clipboard operation
mark copied to clipboard

H1 heading requires a line break

Open lukiffer opened this issue 5 years ago • 3 comments

We follow CommonMark – we have a single H1 to start each document. In most cases this duplicates (or slightly restates) the title from the metadata, which looks weird and takes up unnecessary space in Confluence.

This request is for a flag to remove the leading H1 on all documents before pushing to Confluence.

lukiffer avatar Nov 17 '20 05:11 lukiffer

Is it possible that H1 headings are now always ignored, with or without use of the --drop-h1 flag? I'm not using the flag, and yet my H1 is not being included.

rhbecker avatar Apr 24 '21 00:04 rhbecker

Nevermind - it seems that a line break is required between the metadata and the first line of content.

With this, the H1 isn't rendered in Confluence ...

<!-- Space: <space> -->
<!-- Title: <title> -->
# H1 Title

With this, the H1 is rendered in Confluence ...

<!-- Space: <space> -->
<!-- Title: <title> -->

# H1 Title

If this seems like a bug, I can open a new issue.

rhbecker avatar Apr 24 '21 00:04 rhbecker

@rhbecker thx for the bug report. It is a bug. I'll just rename the issue.

kovetskiy avatar May 20 '21 09:05 kovetskiy