Best of Markdown — October 2025

1. 1
   Article

   Hacker News·27w

   From VS Code to Helix

   A developer shares their journey switching from VS Code to Helix, a terminal-based text editor. Initially hesitant due to concerns about configuration complexity and learning curve, they were motivated by privacy concerns around Microsoft's AI integration and desire for open-source alternatives. The transition proved smoother than expected thanks to Helix's selection-first editing model and built-in tutorial. The post provides detailed setup instructions for Language Server Protocol integration with Markdown (using Marksman and Harper), Astro, and YAML, including formatters like dprint. While praising Helix's out-of-the-box philosophy and efficiency, the author notes the project struggles with PR backlog and could benefit from better contributor onboarding.

   62

   5
2. 2
   Article

   Closer to Code·27w

   Announcing llm-docs-builder: An Open Source Tool for Making Documentation AI-Friendly

   llm-docs-builder is an open-source tool that transforms Markdown documentation into AI-optimized formats, reducing token usage by 85-95% compared to HTML versions. It strips noise like CSS, JavaScript, and HTML boilerplate while preserving semantic structure and context hierarchy. The tool generates llms.txt indexes for AI discoverability and can be configured to automatically serve optimized markdown to AI crawlers while maintaining HTML for human visitors. Real-world metrics from Karafka framework show 20-36x file size reductions, translating to lower RAG costs and fewer hallucinations.

   37

   1
3. 3
   Article

   Everything Astro·28w

   Turn your static site visually editable for non-technical clients & teammates

   Sitepins is a visual CMS that connects to Git repositories, enabling non-technical users to edit static site content without code. It supports popular static site generators like Astro, Next.js, and Hugo, offers a WYSIWYG editor with Markdown support, maintains Git version control, includes media management, and features AI-powered content generation. The tool allows developers to maintain their workflow while giving clients and teammates direct content editing capabilities.

   25

   2
4. 4
   Article

   DEV·31w

   How to serve Markdown to AI agents: Making your docs more AI-friendly

   Content negotiation allows servers to serve Markdown instead of HTML to AI coding assistants by detecting the Accept header in HTTP requests. When AI agents request documentation with Accept: text/markdown, the server responds with raw Markdown, reducing token consumption and improving AI comprehension. The implementation involves detecting the Accept header, serving raw Markdown content when requested, and falling back to HTML for browsers. This approach helps AI agents process documentation more efficiently by eliminating HTML markup bloat.

   16