PyPI · #4020 most downloaded on PyPI

markdown-exec

1.12.31.0M downloads/mopawamoy/markdown-exec ↗New releases in your daily digest, changelog included.

Utilities to execute code blocks in Markdown files.

Last release 2 months ago
07 Jul 2026
Release timing varies
gaps range from 1 weeks to 8 months
Nearly every release is documented
notes for 42 of 42 stable releases
Nothing withdrawn
no release was ever pulled
5 years old
42 releases · first in 2022

Release timeline

42 releases since 2022

20222023202420252026

20222026

One column per quarter.

Releases

1.12.37 Jul 2026
Provide Pyodide options to Zensical (abcb044 by Timothée Mazzucotelli). Issue-100
Compare with 1.12.2

Bug Fixes

Provide Pyodide options to Zensical (abcb044 by Timothée Mazzucotelli). Issue-100

Code Refactoring

Rename material-block source display option to block (2cefa97 by Timothée Mazzucotelli).

Update Pyodide hardcoded version to 314.0.2 (eef2661 by Timothée Mazzucotelli).
Open source →
1.12.25 Jul 2026
Better integrate with Zensical (e4f60c1 by Timothée Mazzucotelli). PR-99
Compare with 1.12.1

Code Refactoring

Better integrate with Zensical (e4f60c1 by Timothée Mazzucotelli). PR-99

1.12.111 Nov 2025

Always register tables extension, needed for Zensical (1f95bf0 by Timothée Mazzucotelli).

Compare with 1.12.0

Code Refactoring

Always register tables extension, needed for Zensical (1f95bf0 by Timothée Mazzucotelli).

Open source →

1.12.010 Nov 2025

Support per-file-extension icons (e6e0d59 by Timothée Mazzucotelli).

Compare with 1.11.0

Features

Support per-file-extension icons (e6e0d59 by Timothée Mazzucotelli).

Open source →

1.11.028 Jun 2025

Add option to set height of Pyodide/Ace editors (c64a2ef by Jayant Pranjal). Issue-41, Co-authored-by: Jayant , Co-authored-by: Timothée Mazzucotelli

Compare with 1.10.4

Features

Add option to set height of Pyodide/Ace editors (c64a2ef by Jayant Pranjal). Issue-41, Co-authored-by: Jayant jayant@Jayants-MacBook-Air.local, Co-authored-by: Timothée Mazzucotelli dev@pawamoy.fr

Open source →

1.10.427 Jun 2025

Don't fail when used as Markdown extension and MkDocs is not installed (7722250 by Timothée Mazzucotelli). Issue-91

Compare with 1.10.3

Bug Fixes

Don't fail when used as Markdown extension and MkDocs is not installed (7722250 by Timothée Mazzucotelli). Issue-91

Open source →

1.10.324 Mar 2025

Also escape strings printed directly to the output (a668aeb by Timothée Mazzucotelli). Issue-87

Compare with 1.10.2

Bug Fixes

Also escape strings printed directly to the output (a668aeb by Timothée Mazzucotelli). Issue-87
Don't forget to clear "Initializing" in Pyodide output (e0b52b4 by Timothée Mazzucotelli).

Open source →

1.10.218 Mar 2025Deprecated

Expose public API under top-level module markdown_exec. Importing from submodules is now deprecated.

Compare with 1.10.1

Deprecations

Expose public API under top-level module markdown_exec. Importing from submodules is now deprecated.

Bug Fixes

Escape Pyodide output, improve error handling (ec83f48 by Timothée Mazzucotelli). Issue-87

Code Refactoring

Sync API and docs (1245ed9 by Timothée Mazzucotelli).
Move code under internal folder (b132e78 by Timothée Mazzucotelli).

Open source →

1.10.111 Mar 2025

Add lower bound to pygments-ansi-color extra (a8e17c9 by Timothée Mazzucotelli).

Compare with 1.10.0

Build

Add lower bound to pygments-ansi-color extra (a8e17c9 by Timothée Mazzucotelli).

Bug Fixes

Fix emoji display in pyodide fence for themes other than Material (e09e9b2 by Timothée Mazzucotelli). Issue-83, PR-84

Open source →

1.10.06 Dec 2024

Drop support for Python 3.8 (103bc1d by Timothée Mazzucotelli).

Compare with 1.9.3

Build

Drop support for Python 3.8 (103bc1d by Timothée Mazzucotelli).

Features

Allow setting Pyodide version (912c8c7 by Andrew). Issue-66, PR-67, Co-authored-by: Timothée Mazzucotelli dev@pawamoy.fr

Open source →

1.9.324 Jun 2024

Fix patching lines in tracebacks on Python 3.13 (917af4c by Timothée Mazzucotelli). Issue-58

Compare with 1.9.2

Bug Fixes

Fix patching lines in tracebacks on Python 3.13 (917af4c by Timothée Mazzucotelli). Issue-58

Open source →

1.9.220 Jun 2024

Render source even if output is empty (d3f1e6b by Timothée Mazzucotelli). Issue-57

Compare with 1.9.1

Bug Fixes

Render source even if output is empty (d3f1e6b by Timothée Mazzucotelli). Issue-57

Open source →

1.9.114 Jun 2024

Re-include tests folder in source distributions (ae549db by Timothée Mazzucotelli). Issue-55

Compare with 1.9.0

Build

Re-include tests folder in source distributions (ae549db by Timothée Mazzucotelli). Issue-55

Open source →

1.9.013 Jun 2024

Abort with error when the plugin is configured to require the ANSI extra but it is not installed (25bcbbe by Timothée Mazzucotelli).

Compare with 1.8.3

Features

Abort with error when the plugin is configured to require the ANSI extra but it is not installed (25bcbbe by Timothée Mazzucotelli).
Allow excluding assets when rendering Pyodide fence (5412353 by Timothée Mazzucotelli).
Detect when SuperFences is not enabled and error out early (5d771d2 by Timothée Mazzucotelli). Issue-39
Allow changing the console width for the execution of code blocks (76d603c by Timothée Mazzucotelli). Issue-34
Allow automatic execution of code blocks thanks to the MARKDOWN_EXEC_AUTO environment variable (0db27b2 by Timothée Mazzucotelli). Issue-24
Allow changing working directory for code blocks execution (ee3fae9 by Timothée Mazzucotelli). Issue-20

Bug Fixes

Reuse existing loggers tp prevent wrong dispatch (8967270 by Timothée Mazzucotelli).
Don't render anything when code block output is empty (4337d13 by Timothée Mazzucotelli). Issue-17
Increase minimum height of Pyodide output code blocks (93598b2 by Timothée Mazzucotelli). Issue-40
Fix removal of temporary div for headings forwarding (c012c1d by Timothée Mazzucotelli). Issue-50

Code Refactoring

Wrap placeholders in <div> to avoid them being wrapped in  (500ed1b by Timothée Mazzucotelli).

Open source →

1.8.322 May 2024

Don't leak future annotations in user code (ba0c35e by Timothée Mazzucotelli). Issue-47

Compare with 1.8.2

Bug Fixes

Don't leak future annotations in user code (ba0c35e by Timothée Mazzucotelli). Issue-47

Open source →

1.8.220 May 2024

Give __name__ to executed Python "modules", and populate sys.modules too (db25ee7 by Timothée Mazzucotelli). Issue-47

Compare with 1.8.1

Bug Fixes

Give __name__ to executed Python "modules", and populate sys.modules too (db25ee7 by Timothée Mazzucotelli). Issue-47

Open source →

1.8.115 Apr 2024

Add missing CSS classes to the ANSI stylesheet (51493f2 by Timothée Mazzucotelli). Issue-43

Compare with 1.8.0

Bug Fixes

Add missing CSS classes to the ANSI stylesheet (51493f2 by Timothée Mazzucotelli). Issue-43

Open source →

1.8.05 Jan 2024

Add pyodide fence (3a2fab0 by Timothée Mazzucotelli).

Compare with 1.7.0

Features

Add pyodide fence (3a2fab0 by Timothée Mazzucotelli).
Add ansi option to mark ANSI extra as required or not (27743c2 by Timothée Mazzucotelli). Issue #28, Issue #29

Code Refactoring

Modernize MkDocs plugin (4864608 by Timothée Mazzucotelli).

Open source →

1.7.017 Oct 2023

Set MKDOCS_CONFIG_DIR environment variable to build file path relative to it (a2cbea5 by Timothée Mazzucotelli).

Compare with 1.6.0

Features

Set MKDOCS_CONFIG_DIR environment variable to build file path relative to it (a2cbea5 by Timothée Mazzucotelli).

Open source →

1.6.018 Apr 2023

Add idprefix option allowing to change/remove HTML id/href prefixes (4d91463 by Timothée Mazzucotelli).

Compare with 1.5.3

Features

Add idprefix option allowing to change/remove HTML id/href prefixes (4d91463 by Timothée Mazzucotelli).

Open source →

1.5.318 Apr 2023

Reuse Markdown configuration as declared in mkdocs.yml (afe091c by Timothée Mazzucotelli).

Compare with 1.5.2

Code Refactoring

Reuse Markdown configuration as declared in mkdocs.yml (afe091c by Timothée Mazzucotelli).

Open source →

1.5.218 Apr 2023

Reset counter in post build event (3bf80de by Timothée Mazzucotelli).

Compare with 1.5.1

Code Refactoring

Reset counter in post build event (3bf80de by Timothée Mazzucotelli).

Open source →

1.5.117 Apr 2023

Remove pycon output lines when rendering source as console (fb5a23d by Timothée Mazzucotelli).

Compare with 1.5.0

Bug Fixes

Remove pycon output lines when rendering source as console (fb5a23d by Timothée Mazzucotelli).
Fix nested rendering (a110d44 by Timothée Mazzucotelli).

Open source →

1.5.017 Apr 2023

Update ToC with generated headings (5ea2263 by Timothée Mazzucotelli).

Compare with 1.4.1

Features

Update ToC with generated headings (5ea2263 by Timothée Mazzucotelli).

Open source →

1.4.116 Apr 2023

Improve handling of errors within sessions (87ac5f3 by Timothée Mazzucotelli).

Compare with 1.4.0

Bug Fixes

Improve handling of errors within sessions (87ac5f3 by Timothée Mazzucotelli).
Swallow non-extra parameters in run functions (f5d4fef by Timothée Mazzucotelli).

Code Refactoring

Simplify tree formatter signature (09d5427 by Timothée Mazzucotelli).

Open source →

1.4.015 Mar 2023

Sessions: persist and reuse state for Python and Pycon code blocks (a8fef5e by Timothée Mazzucotelli). Issue #16

Compare with 1.3.0

Features

Sessions: persist and reuse state for Python and Pycon code blocks (a8fef5e by Timothée Mazzucotelli). Issue #16

Open source →

1.3.018 Feb 2023

Support wrapping result with console source (268c82e by Timothée Mazzucotelli). Issue #13

Compare with 1.2.0

Features

Support wrapping result with console source (268c82e by Timothée Mazzucotelli). Issue #13

Code Refactoring

Remove margin hack from Material source (beec237 by Timothée Mazzucotelli).
Better support pycon syntax (22b51c6 by Timothée Mazzucotelli).

Open source →

1.2.01 Feb 2023

Support ANSI code blocks (39719c5 by Timothée Mazzucotelli). Issue #11

Compare with 1.1.0

Features

Support ANSI code blocks (39719c5 by Timothée Mazzucotelli). Issue #11

Open source →

1.1.027 Jan 2023

Log details to help debugging errors (4c0228d by Timothée Mazzucotelli). Issue #12

Compare with 1.0.0

Features

Log details to help debugging errors (4c0228d by Timothée Mazzucotelli). Issue #12
Allow expecting specific exit codes (620ec66 by Timothée Mazzucotelli). Issue #10

Code Refactoring

Formatters now only accept keyword arguments (0940ca9 by Timothée Mazzucotelli).

Open source →

1.0.024 Nov 2022

Allow defining IDs on code blocks (for warnings) (0091167 by Timothée Mazzucotelli).

Compare with 0.7.4

Features

Allow defining IDs on code blocks (for warnings) (0091167 by Timothée Mazzucotelli).

Code Refactoring

Use base format everywhere (more flexible) (cefba70 by Timothée Mazzucotelli).

Open source →

0.7.413 Nov 2022

Render source for non-HTML output (regression) (3028dcd by Timothée Mazzucotelli).

Compare with 0.7.3

Bug Fixes

Render source for non-HTML output (regression) (3028dcd by Timothée Mazzucotelli).

Open source →

0.7.312 Nov 2022

Don't wrap HTML in p tag (420d79d by Timothée Mazzucotelli).

Compare with 0.7.2

Bug Fixes

Don't wrap HTML in p tag (420d79d by Timothée Mazzucotelli).

Open source →

0.7.21 Sept 2022

Make tree formatter forward extra options (54996a9 by Timothée Mazzucotelli).

Compare with 0.7.1

Bug Fixes

Make tree formatter forward extra options (54996a9 by Timothée Mazzucotelli).
Fix race condition issue (37d7f86 by Timothée Mazzucotelli).

Open source →

0.7.128 Aug 2022

Allow printing non-string objects (ceaa482 by Timothée Mazzucotelli). Issue #7

Compare with 0.7.0

Bug Fixes

Allow printing non-string objects (ceaa482 by Timothée Mazzucotelli). Issue #7

Open source →

0.7.028 May 2022

Add ability to hide source lines (3cb1934 by Timothée Mazzucotelli).

Compare with 0.6.0

Features

Add ability to hide source lines (3cb1934 by Timothée Mazzucotelli).

Open source →

0.6.021 May 2022

Add tree formatter (8096990 by Timothée Mazzucotelli).

Compare with 0.5.0

Features

Add tree formatter (8096990 by Timothée Mazzucotelli).
Handle code blocks execution errors and log warnings (34e16db by Timothée Mazzucotelli).

Bug Fixes

Fix Python execution to support nested scopes (74b9a95 by Timothée Mazzucotelli).

Open source →

0.5.09 May 2022

Allow wrapping result in code block (37201e4 by Timothée Mazzucotelli).

Compare with 0.4.0

Features

Allow wrapping result in code block (37201e4 by Timothée Mazzucotelli).
Add support for shell code blocks (f2b4b67 by Timothée Mazzucotelli).

Code Refactoring

Fetch plugin languages from dict (de8309e by Timothée Mazzucotelli).
Add reusable base formatter (c265bee by Timothée Mazzucotelli).

Open source →

0.4.09 May 2022

Add literate Markdown support (8d3ed7e by Timothée Mazzucotelli).

Compare with 0.3.1

Features

Add literate Markdown support (8d3ed7e by Timothée Mazzucotelli).
Add material-block style to show source (ff10ee1 by Timothée Mazzucotelli).
Support up to 8 levels of exec code block nesting (bfde808 by Timothée Mazzucotelli).

Open source →

0.3.17 May 2022

Actually prevent HTML re-rendering (4374852 by Timothée Mazzucotelli).

Compare with 0.3.0

Bug Fixes

Actually prevent HTML re-rendering (4374852 by Timothée Mazzucotelli).

Open source →

0.3.01 May 2022

Support pycon code blocks (2c86394 by Timothée Mazzucotelli).

Compare with 0.2.0

Features

Support pycon code blocks (2c86394 by Timothée Mazzucotelli).
Add console source integration option (62dfd74 by Timothée Mazzucotelli).
Provide a MkDocs plugin for easier setup (5fce814 by Timothée Mazzucotelli).
Support changing tabs titles (d150596 by Timothée Mazzucotelli).
Allow using print in code blocks (7c124fd by Timothée Mazzucotelli).
Allow passing extra opts like title to source code blocks (bb3252a by Timothée Mazzucotelli).

Code Refactoring

Split Python formatter to allow reuse (fc56702 by Timothée Mazzucotelli).
Setup a more robust Markdown converter (395f4c4 by Timothée Mazzucotelli).

Open source →

0.2.018 Apr 2022

Add ability to render using tabs (91a95ae by Timothée Mazzucotelli).

Compare with 0.1.0

Features

Add ability to render using tabs (91a95ae by Timothée Mazzucotelli).

Open source →

0.1.019 Feb 2022

Implement execution of code blocks (41c8d81 by Timothée Mazzucotelli).

Compare with first commit

Features

Implement execution of code blocks (41c8d81 by Timothée Mazzucotelli).

Open source →

Your coding agent can read these notes before it upgrades. Set up the MCP server →