Autodoc (sphinx.ext.autodoc) cannot be used in a .md file

I wanted to use the Sphinx autodoc module. I made it work in .rst files, but I failed to add autogenerated API documentation to a .md file.

In my _config.yml, I have

sphinx:
  extra_extensions:
    - 'sphinx.ext.autodoc'

In a .rst file, I can write

.. automodule:: amqcfg
    :members: generate

To Reproduce

Add a .md file with content translated from the .rst file.

I am unsure of correct syntax, so I tried twice

first attempt

```{automodule} amqcfg
members: generate
```

renders as

.. py:module:: amqcfg

members: generate

second attempt

```{automodule} amqcfg
---
members: generate
---
```

gives build warning

# PYTHONPATH=`pwd` jupyter-book build docs
Running Sphinx v2.4.4
loading pickled environment... done
building [mo]: targets for 0 po files that are out of date
building [html]: targets for 1 source files that are out of date
updating environment: 0 added, 1 changed, 0 removed
reading sources... [100%] api                                                                                                                                
/mnt/YamlConfiger/docs/api.md:63: WARNING: Directive 'automodule': Unknown option: members

---
members: generate
---
looking for now-outdated files... none found
[...]

Expected behavior

I’d like to be able to use the autodoc feature regardless of whether I am writing in .rst or .md.

Environment

• Python Version: 3.8.2
• Package versions or output of jupyter-book --version: **Jupyter Book: 0.7.4 **MyST-NB: 0.8.5 **Sphinx Book Theme: 0.0.35 **MyST-Parser: 0.9.1 **Jupyter-Cache: 0.3.0
• Operating System: Ubuntu Focal

[B-Noumedem]

I also have the same issue about generating API reference with Jupyter-book. I want to use the API reference as the last chapter of the package documentation. Any updates ? Thanks a lot

[nickmachairas]

Bumping this issue because it is the earliest mention I can find of setting the absolute path to the module as autodoc requires. Any updates? Thanks