title: How can I use automodule or autoclass for Sphinx in a markdown file?
body: <p>I understand the Sphinx supports markdown or .md files optionally, which works great for me for my supplimental documentation. What I am trying to do is use the <code>autoclass</code> or <code>automodule</code> tags in a markdown file. </p>
  
  <p>Normally, in a <code>.rst</code> file, if I do </p>
  
  <pre><code>.. autoclass:: my.module.SomeClass
      :members:
  </code></pre>
  
  <p>it will automatically pull all the docstrings and create the documentation. Is it possible to use this in <code>.md</code> files? At the moment, when I attempt to do so, the generated docs only contains <code>.. autoclass:...</code> which is expected. </p>
  
  <p>My <code>conf.py</code> is </p>
  
  <pre class="lang-py prettyprint-override"><code>extensions = ["sphinx.ext.autodoc", "sphinx.ext.napoleon", "recommonmark"]
  source_suffix = {
      '.rst': 'restructuredtext',
      '.txt': 'markdown',
      '.md': 'markdown',
  }
  </code></pre>
  
  <p>Because of read the docs compatibility, I did consider mkdocs, but it does not offer autodoc like capabilities. I am very open to any other library (does not have to be RTD compatible) in order to accomplish this. </p>