DEV Community

MDTools
MDTools

Posted on

Why Every Medical Formula Needs a Citation (And How We Handle It)

Medical calculators are used millions of times a day. A nurse calculates a heparin drip rate. An ER physician scores a Glasgow Coma Scale. A nephrologist checks an eGFR. Each of these calculations has a formula behind it -- and that formula has a story.

At MDTools.org, we believe every medical formula deserves a citation. Here's why, and how we approach it.

The Problem with "Trust Me" Calculators

Many medical calculator websites show you a result without telling you where the formula came from. That's dangerous in medicine. A doctor should be able to:

  1. Verify the formula against the original publication
  2. Check the study population -- was the formula validated for their patient?
  3. Know the limitations -- every formula has edge cases

How We Handle Citations

Every calculator on MDTools includes:

Original Research Papers

For example, our eGFR Calculator cites the CKD-EPI 2021 equation from Inker et al. (NEJM, 2021). The MELD Score references Kamath et al. (Hepatology, 2001) and the 2016 MELD-Na update.

Clinical Guidelines

Our CHA2DS2-VASc Calculator references the ESC/ACC guidelines for atrial fibrillation management. The ASCVD Risk Calculator cites the 2013 ACC/AHA Pooled Cohort Equations.

Textbook References

For lab reference values, we cite Tietz Clinical Chemistry and Molecular Diagnostics, the gold standard reference:

Drug Dosing: Where Citations Matter Most

Drug dosing calculators have the highest stakes. A wrong dose can kill. Here's how we handle it:

Weight-Based Protocols

Titration Schedules

Pediatric Dosing

The Technical Side

Our citation approach is simple:

  1. Each calculator page has a "Formula Details" section with the mathematical formula
  2. Below that, a "References" section with full citations
  3. A "Formula last verified" date so users know when the formula was last checked
  4. An FAQ section addressing common clinical questions

We also use Schema.org FAQPage markup so that Google can show our clinical Q&As directly in search results.

Specialized Calculators

Beyond the basics, we've built tools for specific clinical scenarios:

Multilingual Access

Medical knowledge shouldn't have a language barrier. Every tool is available in German as well as English, with more languages planned.

Open Source = Auditable

The entire codebase is open source on GitHub. Anyone can:

  • Verify our formulas against the cited papers
  • Submit corrections if they find an error
  • Suggest new calculators

In medicine, "where did you get that number?" isn't a rude question -- it's the most important one. Every calculator should be able to answer it.

Check out MDTools.org -- all 100+ tools are free, forever.

Top comments (0)