Sphinx (http://sphinx-doc.org/), my tool of choice for writing documentation, includes an extension that does this: http://sphinx-doc.org/ext/doctest.html.