[ggm]

I wish more markdowns accepted some notation for keyword bullet lists. Indented lists which mark with a bolded or emphasised term.

If you can do this, you can write manual pages for options or flags

[dredmorbius]

There is an extended syntax for that:

  First Term
  : This is the definition of the first term.

  Second Term
  : This is one definition of the second term.
  : This is another definition of the second term.

<https://www.markdownguide.org/extended-syntax>

[ggm]

How this renders is suboptimal to me. It's like a variant of heading.

I meant

  -a        the minus aflag text
  -b        the minus bflag text
  Something the something text

It's basically table or grid layout without lines.

[oneeyedpigeon]

That's a CSS issue rather than anything to do with markdown or the markup it generates.

[dredmorbius]

This.

Markdown (or other markup languages, lightweight or otherwise) in general specify semantic document structure.

The presentation or layout are defined by the style and/or stylesheet --- CSS in the case of markdown.

That said, the definition list is intended to be something of a header/content block, as defined by the W3C.

[toastal]

> keyword bullet lists

You mean a definition list like the HTML native one?

[oneeyedpigeon]

I'm sure they mean DLs, yes - this is the one thing I always bemoan that markdown lacks, even more so than tables.

[toastal]

### But my headings

* can be a definition list

* if I don’t actually care about semantics