privatenumber

privatenumber / mdeval

Public

Evaluate JavaScript in Markdown and interpolate results in-place

cli dynamic eval javascript markdown
17
0
100% credibility
Found Mar 31, 2026 at 17 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
TypeScript
AI Summary

A tool for embedding dynamic computations like package versions or tables directly into Markdown files using invisible comments that update the content in place.

How It Works

1
💭 Dream of smart notes

You want your Markdown files to show fresh info like current versions or stats without forgetting to update them.

2
📥 Get the updater tool

Pick up the handy little helper that brings your notes to life.

3
📖 Open your document

Find the Markdown file where you want dynamic magic.

4
✨ Add secret thinkers

Slip in hidden instructions for calculations and placeholders for the results right inside your text.

5
▶️ Run the refresh

Press go, and watch it compute and swap in the live values automatically.

🎉 Perfect live docs!

Your file now glows with up-to-date details, sharing beautifully anywhere without a trace of the magic.

Sign up to see the full architecture

4 more

Sign Up Free

Star Growth

See how this repo grew from 17 to 17 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is mdeval?

mdeval lets you embed and evaluate JavaScript directly in Markdown files using invisible HTML comments, interpolating dynamic results like package versions, GitHub star counts, or computed tables right in-place. Run the CLI command `mdeval README.md` to execute script blocks (full Node.js with ESM and top-level await) and replace value markers with fresh output, keeping your docs self-contained without separate generation scripts. Written in TypeScript, it processes files in-place and supports importing logic from other Markdown files.

Why is it gaining traction?

Unlike static badges or forgotten generators, mdeval keeps JS logic next to the content it powers, rendering cleanly on GitHub or any viewer since comments hide seamlessly. Self-contained markers with inline IIFEs and a `block()` helper for formatted output like tables make it dead simple for live data, while shared runtime across files speeds batch processing. Developers love it for evaluating GitHub repos, profiles, or JavaScript libraries (browser, Android, Flutter, Playwright) without extra tools.

Who should use this?

README maintainers embedding live npm versions or GitHub stars to evaluate repos accurately. Tech writers generating dynamic tables for JavaScript in Python/Java/Swift docs, or evaluating LLMs/Hugging Face models via agent skills. Open-source authors tired of stale stats in changelogs, especially for Robot Framework or STIG ruleset benchmarks.

Verdict

Grab it for niche dynamic Markdown needs—solid CLI, great docs, and md-pen integration make it practical despite 17 stars and 1.0% credibility score signaling early maturity. Test on non-critical docs first; it's promising but needs more adoption for edge cases.

(198 words)

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.