myst-nb

import os # --- conf.py (Sphinx configuration file) --- # project = 'MyST-NB Quickstart' # copyright = '2026, Your Name' # extensions = [ # 'myst_nb', # 'sphinx.ext.autodoc', # Example standard Sphinx extension # ] # # Optional: Configure notebook execution # # nb_execution_mode = "auto" # 'auto', 'off', 'force', 'cache' # # nb_execution_timeout = 60 # --- example.md (MyST Markdown file with code cells) --- example_md_content = ''' # MyST-NB Example Document This is a MyST Markdown file demonstrating executable code cells. ```{code-cell} python import datetime print("Hello from MyST-NB!") print(f"Current time: {datetime.datetime.now()}") ``` You can also use the `glue` functionality to embed variables from executed cells. ```{code-cell} python from myst_nb import glue my_result = "This value was 'glued' from a Python cell." glue("my_embedded_string", my_result) ``` The result embedded from the code cell is: {glue:text}`my_embedded_string`. ''' # To run this, you would typically: # 1. Create a Sphinx project (e.g., `sphinx-quickstart`) # 2. Modify `conf.py` as commented above # 3. Create `example.md` with the content above # 4. Build with `sphinx-build -b html . _build` # This snippet simulates saving the content to files for demonstration. # In a real Sphinx project, these files would exist in your source directory. # (Not actually running sphinx-build here, just showing file content) print("--- Simulated conf.py content ---") print("# See comments in code for full conf.py example") print("extensions = ['myst_nb']") print("\n--- Simulated example.md content ---") print(example_md_content)