From 5821dceef56664fcc1382a6a3600fd6c3333768a Mon Sep 17 00:00:00 2001
From: Ray Speth <speth@mit.edu>
Date: Thu, 28 Sep 2023 22:57:08 -0400
Subject: [PATCH] Enable MyST usage in Sphinx

---
 doc/sphinx/conf.py | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/doc/sphinx/conf.py b/doc/sphinx/conf.py
index ea0013869..915a4ca70 100644
--- a/doc/sphinx/conf.py
+++ b/doc/sphinx/conf.py
@@ -43,6 +43,7 @@ extensions = [
               'sphinxarg.ext',
               'sphinxcontrib.doxylink',
               'sphinx.ext.intersphinx',
+              'myst_parser',
               'sphinx_gallery.gen_gallery',
               'sphinx_tags',
               'sphinx_design',
@@ -216,6 +217,8 @@ intersphinx_mapping = {
     'pint': ('https://pint.readthedocs.io/en/stable/', None),
 }
 
+myst_enable_extensions = ["dollarmath", "amsmath"]
+
 # Ensure that the primary domain is the Python domain, since we've added the
 # MATLAB domain with sphinxcontrib.matlab
 primary_domain = 'py'
@@ -224,7 +227,7 @@ primary_domain = 'py'
 templates_path = ['_templates']
 
 # The suffix of source filenames.
-source_suffix = '.rst'
+source_suffix = ['.rst', '.md']
 
 # The encoding of source files.
 #source_encoding = 'utf-8-sig'