(Question) How do I use markdown with kedro build-docs?

I have a ned kedro project on 0.17.0.

I would like to be able to drop markdown in the docs/source directory for some page, but they aren’t automatically added to the index out of the box.

I’ve struggled with sphinx enough in the past to understand there are many ways to do it and I typically do not choose the most convenient way.

1 Like

I tried glob in toctree explained in the following Sphinx document, but Sphinx 3.5.1 (latest version) seems to support only .rst and not .md (markdown).
https://www.sphinx-doc.org/en/master/usage/restructuredtext/directives.html
rst

After struggling, I couldn’t find a better way than manually adding the relative paths to the markdown files like this:

I’d like to know a better way as well.