Skip to content

Conversation

@mschoettle
Copy link
Contributor

Description

I was going through the changelog of the latest version and noticed an incorrectly rendered list in https://static-web-server.net/features/markdown-content-negotiation/#llm-friendly-content-with-llmstxt at the end of that section:

This approach is superior to traditional .md URL suffixes because: - Uses standard HTTP content negotiation - Same URL serves both HTML (browsers) and Markdown (LLMs) - No need for separate URL structures or redirects - Follows REST principles for resource representation

Related Issue

Motivation and Context

Note that it would be possible to catch (and fix) this automatically via mdformat with the mdformat-mkdocs plugin. I use it as a pre-commit hook but could also be added to CI only.

Let me know if this is something you would find useful and I could contribute a PR.

How Has This Been Tested?

Screenshots (if appropriate):

@semanticdiff-com
Copy link

Review changes with  SemanticDiff

@joseluisq
Copy link
Collaborator

joseluisq commented Dec 5, 2025

Hi, checking and formatting the docs via https://github.com/hukkin/mdformat on CI sounds interesting.

You could use something like this:

mdformat --check ./*.md docs/**

It is enough to check for all root-level only and docs/** markdown files.

Can you please add it to CI as a new step? I created a dedicated workflow for the project docs. Just make sure to add it after the typos check and before the mkdocs build.

--

Btw, I believe you can close this PR and address the same in a new one by applying the formatting via mdformat ./*.md docs/**.

@mschoettle
Copy link
Contributor Author

Closing in favour of #597.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants