Include Sphinx Projects in MyST

Configure Your Project¶

The Sphinx conf.py for your project should include sphinx-ext-mystmd. If your Sphinx project lives under sphinx, then your conf.py might look like.

extensions = [
    "sphinx_ext_mystmd"
]

Build the Sphinx Project¶

sphinx-build -b myst sphinx myst-asts

Configure the MyST Project¶

version: 1
project:
  toc:
    - file: index.md
    - pattern: myst-asts/**.myst.json
site:
  template: book-theme

Build the MyST Project¶

myst start