smalldocs

of the three architectures with mermaid diagrams" and then I can review the agent's thinking in a cleaner way.

ite. This means the SmallDocs renderer can convert recognised Markdown combinations into powerful traditional document formats [2]. For example, we convert a ```cells block into an in-line spreadsheet you can export to Excel. This gives an agent the ability to express itself with a great deal of depth and flexibility. For example, your agent can produce a single data analysis "SmallDoc" with text, charts, spreadsheets, etc. [3] I find that combining formats quickens the speed I can understand a topic. SmallDocs also have standardised and pretty boring styling. This means you spend less time understanding the layout of a flashy HTML page and more time on the content. I also believe a pre-determined rendering engine has a lot of advantages over a freslhy built HTML artifact. It allows you to build in lot's of useful defaults that the agent doesn't have to code from scratch. These can be small things, for example, every time your agent renders a Markdown table in SmallDocs you can instantly copy it as a CSV or a PNG. And these can be bigger things, such as a rich slides DSL with solid styling defaults, which saves your agents a lot of tokens and results in consistently attractive HTML slides [4]. (Slides can also be automatically exported to .pdf and .pptx.) I've been at it for a few months, and am still working on the project. I am looking for feedback and open source collaborators. Thanks for reading! [0] https://smalldocs.org [1] https://github.com/espressoplease/smalldocs [2] https://smalldocs.org/blogs/what-is-a-smalldoc [3] https://smalldocs.org/s/46fWiAyF77T9c7tqYwAQqp#k=j78ZEOOrgo8... [4] https://smalldocs.org/s/QrmeWMsULGS871nXQYOacB#k=ubOHH9QtTWp... (And something totally different, your agent can also use SmallDocs to walk you through code files: https://smalldocs.org/s/JsI_-tWSH0UpSd_YXxVLPm#k=G5jLCYA4JUX...)

l document formats [2]. For example, we convert a ```cells block into an in-line spreadsheet you can export to Excel. This gives an agent the ability to express itself with a great deal of depth and flexibility. For example, your agent can produce a single data analysis "SmallDoc" with text, charts, spreadsheets, etc. [3] I find that combining formats quickens the speed I can understand a topic. I also believe a pre-determined rendering engine has a lot of advantages over a freslhy built HTML artifact. It allows you to build in lot's of useful defaults that the agent doesn't have to code from scratch. These can be small things, for example, every time your agent renders a Markdown table in SmallDocs you can instantly copy it as a CSV or a PNG. And these can be bigger things, such as a rich slides DSL with solid styling defaults, which saves your agents a lot of tokens and results in consistently attractive HTML slides [4]. (Slides can also be automatically exported to .pdf and .pptx.) I've been at it for a few months, and am still working on the project. I am looking for feedback and open source collaborators. Thanks for reading! [0] https://smalldocs.org [1] https://github.com/espressoplease/smalldocs [2] https://smalldocs.org/blogs/what-is-a-smalldoc [3] https://smalldocs.org/s/46fWiAyF77T9c7tqYwAQqp#k=j78ZEOOrgo8... [4] https://smalldocs.org/s/QrmeWMsULGS871nXQYOacB#k=ubOHH9QtTWp... (And something totally different, your agent can also use SmallDocs to walk you through code files: https://smalldocs.org/s/JsI_-tWSH0UpSd_YXxVLPm#k=G5jLCYA4JUX...)

basis (https://smalldocs.org/analytics), but right now it's just a free local-first tool. Code available here: https://github.com/espressoplease/smalldocs

With SmallDocs, I built on the standard rendering of markdown, but then added a bunch of properties which traditional markdown renders would ignore. For example, styles front matter: --- styles: fontFamily: Lora baseFontSize: 17 h1: { fontSize: 2.3, fontWeight: 700 } p: { lineHeight: 1.9, marginBottom: 1.2 } ... --- Which means you can create colorful files like: https://smalldocs.org/s/v_CHCaQHdGNVlsQtk6skEY#k=ZajP0oeiW86... And slide blocks like: ~~~slide grid 100 56.25 bg=#0b1220 r 6 9 82 4 text=caption color=#fbbf24 align=left | LAUNCH REVIEW - Q2 2026 r 6 18 84 16 text=title color=#f8fafc align=left | Atlas 2.0 shipped to every customer r 6 37 78 6 text=subtitle color=#94a3b8 align=left | What changed, what it cost, and what we learned l 6 47 24 47 stroke=#fbbf24 strokeWidth=0.2 ~~~ Which means you can generate slides like: https://smalldocs.org/s/EKnIk-YdUBZeDA9yQs97mh#k=Eo-p46k-k6Q... All this means SmallDocs markdown files only render correctly through our rendering engine - but this enables me to add something new to an existing document format. [1] https://smalldocs.com; https://github.com/espressoplease/smalldocs