Ignore front-matter flag/config

[titpetric]

I'd like to use mdox to reformat markdown documents (hugo), but not touch the front-matter. Currently the front-matter gets reordered and reindented, rather than being kept as is.

[bwplotka]

👍🏽 help wanted!

[titpetric]

@bwplotka this is a persistent pain in my butt and i'd like to contribute a PR for it;

the few issues arising from this are:

• front-matter resorting
• front-matter reindenting

Asume we can add --skip-front-matter, there is the question if configuring resorting and indenting would make sense. In that case, there would be multiple options to configure (skip front matter sort, skip front matter reindent, set front matter reindent to tab/space, set front-matter reindent size).

The latter options could be derived from .editorconfig but it requires adding support for it in mdox, right? The flags that are interesting there are indent_size, indent_style, and suppose some matching to find *.md or fall back to *. The whole app has few settings, so I am motivated to add as little flags as absolutely necessary, which in this case is some format of --skip.<step> under mdox fmt and .editorconfig support.

I'd like your input here, mainly around the flags to support this, or if .editorconfig support is desired.

[bwplotka]

Skipping does not sounds too bad. Never seen editor config convention, not sure how popular it is, but long term we might want a separate config file or so.

Curious what's wrong with front matter reorder/formatting? Maybe it's better to ensure there are options you would be happy with e.g. indent size or so?

Another idea would be to check the current indentation for the first item in the yaml and persist that? Less config options= better

[titpetric]

Front-matter reordering would require review, and we'd like to keep that on markdown-side only. Also asuming from a dataset of about a 1000 pages, not all input is trustworthy so we can't just mdox fmt and be done with it. Suppose it's an issue from a git history perspective as well as the blame on the metadata would change by reordering, etc.

Editorconfig does present a challenge; yes, someone can add *.md settings, but this is technically *.yaml; While I'm happy it's an open standard and has quite a bit of adoption, it was just in avoidance of having fine grained skip flags.

can we go with --skip-front-matter, or just --soft-matter (default to true?). If there's a preferred naming option for the skip flag under mdox fmt, I'd like to take that and go with it :)