{"slug": "show-hn-readmer-is-a-compiler-for-building-readmes-from-liquid-jinja2-templates", "title": "Show HN: Readmer is a compiler for building READMEs from Liquid/Jinja2 templates", "summary": "A developer has released Readmer, a compiler that builds README.md files from Liquid or Jinja2 templates, aiming to reduce repetitive work for maintainers of multi-package projects. The tool stores templates in a .config/readmer/ directory and supports features like rendering CSV files as Markdown tables. The author explicitly rejects using LLMs to generate READMEs, citing concerns about AI slop.", "body_md": "As a somewhat prolific open-source author over the past 25 years, I maintain hundreds of Rust crates, Ruby gems, Python packages, and so on. One of the painful aspects of large projects consisting of dozens of packages has been the individual READMEs for each package, with lots of repetitive elements but also a great deal of necessary package-specific variation.\n\nNow, before anyone asks, I *don't* want to just have an LLM generate my READMEs. People are increasingly sensitive to AI slop, and that certainly starts with a project's README: slop is readily recognizable through LLMs' lack of good judgment on README contents. More isn't always better: *\"If I had more time, I would have written a shorter letter\"* and all that.\n\nI believe that at this point given widespread, complex formatting of READMEs, what with CI badges, headers, footers, tables, images, inline HTML, etc, etc, we've in any case realistically drifted quite far from the original human-readable vision of Markdown as such. Perhaps, then, we ought to consider whether README.md files really should not best be treated just as built documentation outputs, not as sacred artisanal relics to be read on a 80×24 monochrome screen?\n\nAlong these lines, I present Readmer, a first attempt at a proper README compiler. Readmer composes README.md files from Liquid or Jinja2 templates stored in an unobtrusive .config/readmer/ project directory, with lots of nifties such as support for rendering CSV files as Markdown tables. I hope it comes useful to someone!\n\n``` bash\n    $ cargo binstall -y readmer\n\n    $ cargo new myproject && cd myproject\n    $ mkdir -p .config/readmer/\n    $ echo '# {{ package.name | capitalize }}' > .config/readmer/README.md.liquid\n    $ readmer render > README.md\n```\n\nComments URL: [https://news.ycombinator.com/item?id=49012191](https://news.ycombinator.com/item?id=49012191)\n\nPoints: 1\n\n# Comments: 0", "url": "https://wpnews.pro/news/show-hn-readmer-is-a-compiler-for-building-readmes-from-liquid-jinja2-templates", "canonical_source": "https://github.com/artob/readmer", "published_at": "2026-07-22 19:31:07+00:00", "updated_at": "2026-07-22 19:52:46.900428+00:00", "lang": "en", "topics": ["developer-tools"], "entities": ["Readmer"], "alternates": {"html": "https://wpnews.pro/news/show-hn-readmer-is-a-compiler-for-building-readmes-from-liquid-jinja2-templates", "markdown": "https://wpnews.pro/news/show-hn-readmer-is-a-compiler-for-building-readmes-from-liquid-jinja2-templates.md", "text": "https://wpnews.pro/news/show-hn-readmer-is-a-compiler-for-building-readmes-from-liquid-jinja2-templates.txt", "jsonld": "https://wpnews.pro/news/show-hn-readmer-is-a-compiler-for-building-readmes-from-liquid-jinja2-templates.jsonld"}}