Articles tagged: Documentation as Code
Follow Documentation as Code
They land in your feed reader on their own — no account, no email address, nothing to unsubscribe from. Paste this URL into your reader:
https://www.avonture.be/blog/tags/doc-as-code/rss.xmlNo feed reader yet? Start here — it takes two minutes.
ai-diagram: From a Sentence (or a compose.yaml) to a Mermaid Diagram →
A zsh function that turns a plain-English description, or an existing config file like a docker-compose.yaml, into a Mermaid diagram — printed as a ready-to-paste fenced code block. Where docker-python-mermaid needs a script written for each input format, ai-diagram takes whatever you have in hand.
October 15, 2026
Drawing a Map of My Own Blog →
Build an interactive map of your whole Docusaurus corpus — every article as a bubble wearing the site's mascot, sized by how many other posts link to it, positioned by a force-directed layout that runs at build time in Node so the browser never ships d3-force. Includes the plugin, the canvas component, and the plain-list fallback that keeps the page usable with JavaScript disabled.
October 8, 2026
Docling - Convert PDF, Word, PowerPoint, Excel and HTML to Markdown, GPU-Accelerated →
A Docker batteries-included setup for Docling, IBM's document-conversion library: PDF, Word, PowerPoint, Excel and HTML files converted into clean Markdown, with GPU acceleration for machines with spare VRAM. A companion to my Markitdown article — same idea, a heavier engine underneath.
September 17, 2026
Documentation as Code - Transform Your Infrastructure into Beautiful Diagrams with Python and Mermaid →
Automate your Documentation as Code by building a Dockerized Python and Mermaid CLI stack to generate dynamic architecture diagrams directly from your codebase.
April 20, 2026
Quarto - How I Built a Self-Documenting Ecosystem for 50+ Projects →
A deep dive into how I engineered a fully automated documentation ecosystem using Quarto and Docker, transforming documentation from a chore into a high-performance build pipeline.
March 16, 2026
Getting a more attractive mindmap with Markmap and Quarto →
Generate attractive mindmaps from Markdown using Markmap and customize them in VSCode. Render the final, beautiful HTML result with Quarto and Docker.
July 25, 2025
My favorite Quarto extensions →
My favorite Quarto extensions - Learn about essential Quarto filters for partial content templating, Font Awesome icons, including external code files, and simple search-replace macros to enhance your documentation workflow.
May 3, 2025
Python - Generate flows using pydot →
Use Python and the pydot library to easily generate diagrams-as-code like ETL flowcharts, class diagrams, and decision trees. Includes Docker setup and code examples.
December 18, 2024
Drawdb-app - Render your database model as png, markdown, mermaid, ... →
Easily visualize and document your database model with DrawDB-app. Import SQL files, generate diagrams, and export to PNG, Markdown, Mermaid, and more.
November 11, 2024
How to generate a graph from compose.yaml →
Instantly visualize your Docker Compose architecture. Use `compose-viz` to generate a clear graph of services, dependencies, and exposed ports from your `compose.yaml` file.
June 8, 2024
Rendering a JSON file as a mind map →
Transform complex JSON data into clear, interactive mind maps with JSON Crack. Discover how this powerful tool simplifies data visualization and enhances data understanding.
January 18, 2024
Running Quarto Markdown in Docker →
Run Quarto Markdown in Docker for easy documentation and slideshow generation. Learn to build your own Docker image and render Markdown to PDF, HTML, and Reveal.js.
December 21, 2023
Build a mind map using Docker and Markdown →
Learn how to easily create a dynamic mind map using Markmap, Docker, and Markdown. Convert plain text into a beautiful, interactive HTML mind map.
December 16, 2023
Docker - Diagrams as code →
Generate stunning infrastructure and application diagrams directly from Python code using the diagrams library and a simple Docker command. Visualize your complex systems as code effortlessly.
November 24, 2023