Experiment: markdown-output api docs

.github/workflows/generate-cli-api-docs.yml

@@ -145,6 +145,7 @@ jobs:
 
           echo "creating docs"
           make html
+          make markdown
 
       - name: debug
         run: |

core/dbt/docs/source/conf.py

@@ -20,10 +20,10 @@ author = "dbt Labs"
 # -- General configuration ---------------------------------------------------
 # https://www.sphinx-doc.org/en/master/usage/configuration.html#general-configuration
 
-extensions = ["dbt_click"]
+extensions = ["dbt_click", "sphinx_markdown_builder"]
 
 templates_path = ["_templates"]
-exclude_patterns: t.List[str] = []
+exclude_patterns: t.List[str] = ['build/*']
 
 # -- Options for HTML output -------------------------------------------------
 # https://www.sphinx-doc.org/en/master/usage/configuration.html#options-for-html-output

dev-requirements.txt

@@ -19,6 +19,7 @@ pytest-mock
 pytest-xdist
 pytz
 sphinx
+sphinx-markdown-builder
 tox>=3.13
 twine
 types-colorama