Make use of HTML sectioning elements

[EsseLowNitro]

The website is structured in a hard-coded way with some HTML semantic tags: the <header> contains a <nav>, all rendered markdown content is wrapped inside a <main> section, and a <footer> closes the page body, all parts in correct tags for their purposes. But inside the <main> part, the rendered markdown is, basically, a simple conversion of symbols (eg. # [text] wraps [text] in a level 1 heading), with the renderer not aware of the context of these symbols, which could be considered to make use of HTML sectioning elements, too, when appropriate.

For a few examples, a level 2 heading and its pertaining paragraphs (and any other elements) could be wrapped in an <article> element. A level 2 heading with lower level headings could be wrapped in a <section> element, with the lower level headings inside an <article>. A table of contents could be in a <nav>.

The examples above reflect what the GrapheneOS website uses in the FAQ page:

Other pages use different nesting schemes of article and section elements, and I couldn't really distinguish why.

This can be automated if a solid recommendation can be followed, but should require using (finding or creating) Jekyll plugins to modify the way markdown pages are rendered. Tho, creating plugins for tasks like these is easy and shouldn't require much maintenance.