feat: generate per-doc markdown files via docusaurus-plugin-llms#82
Open
RicardoStoklosa wants to merge 4 commits into
Open
feat: generate per-doc markdown files via docusaurus-plugin-llms#82RicardoStoklosa wants to merge 4 commits into
RicardoStoklosa wants to merge 4 commits into
Conversation
Bump docusaurus-plugin-llms to 0.4.0 and enable generateMarkdownFiles so each doc page is exposed as a .md sibling. llms.txt links now point to those .md URLs (default addMdExtension behavior), which lets TagoDeploy and other consumers fetch the raw markdown for rendering. Preserves title and description front matter on generated files.
felipefdl
approved these changes
May 29, 2026
Freddyminu
approved these changes
May 29, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
docusaurus-plugin-llmsfrom^0.3.0to^0.4.0.generateMarkdownFiles: trueso every doc page is emitted as a sibling.mdfile in the build output (e.g./tagodeploy/new-project.md).titleanddescriptionfront matter on the generated files viakeepFrontMatter.The plugin defaults to
addMdExtension: true, sollms.txtnow links to the.mdversions instead of HTML pages. TagoDeploy (and other consumers) can fetch those URLs directly to render the docs as markdown.Why
TagoDeploy needs the raw markdown of each doc to render help content inside the product. The 0.4.0 release of
docusaurus-plugin-llmsadds first-class support for emitting per-doc.mdfiles alongside the existingllms.txt/llms-full.txtartifacts.Risk (CIA)
Test plan
npm installsucceeds with minimal lockfile deltanpm run buildsucceeds.mdfiles generated underbuild/matching the docs treebuild/llms.txtandbuild/llms-full.txtstill generatedbuild/tagodeploy/new-project.mdcontains preservedtitle/descriptionfront matterhttps://docs.beta.tago.io/<path>.mdresolves