Render h1 from markdown

[bdrtsky]

Currently Docus treat h1 separate from other content https://github.com/nuxtlabs/docus/blob/main/src/defaultTheme/components/organisms/PageContent.vue#L12-L37

This could be confusing and unexpected. Maybe we should rethink this approach, and render h1 along with other markdown content. This is expected, and also it doesn't have additional mental load on were to search where rendered h1 was placed in template.

We can still use it for frontmatter, just change rendering part.

I believe this will affect current template, so it also will need a rethink.

[atinux]

I fully agree, it was quite weird to have the first H1 not rendered.

[Tahul]

What should happen is that the H1 fills the frontmatter title if it's empty.

Same for description with first paragraph.

By default it should always be displayed.

Maybe this could be an option from theming, but for now I think everything from the .md file should definitely be displayed.

[farnabaz]

Is this still valid?
if so, I believe we should change the behavior before Nuxtjs.org release to prevent huge breaking change in contents. Both document and UI require changes
Note that it will be a breaking change since we use blockquote to define page description

[atinux]

I believe so, we need to do it before release nuxtjs.org with Docus yes.

Also, I think we should not use the bloquote but the first paragraph for filling the front-matter description.