title: How to automatically generate Python API documentation in PyCharm
body: <p>I have a Python project in PyCharm and I'd like to automatically generate API documentation (in the form of HTML) from my Python code and docstrings.</p>
  
  <p>According to <a href="https://wiki.python.org/moin/DocumentationTools" rel="noreferrer">this page</a>, there are a number of tools that generate Python API documentation:</p>
  
  <ul>
  <li>autosummary</li>
  <li>autodoc</li>
  <li>pdoc</li>
  <li>PyDoc</li>
  <li>pydoctor</li>
  <li>Doxygen</li>
  </ul>
  
  <p>The page additionally notes that the following tools "process documentation":</p>
  
  <ul>
  <li>DocUtils</li>
  <li>Sphinx</li>
  </ul>
  
  <p>The <a href="https://www.jetbrains.com/help/pycharm/2016.1/generating-reference-documentation.html" rel="noreferrer">PyCharm documentation says</a> that DocUtils and Sphinx can be used to "produce the formatted API documentation". However, this seems to be incorrect, as <a href="https://www.jetbrains.com/help/pycharm/2016.1/run-debug-configuration-docutil-task.html" rel="noreferrer">their configuration indicates</a> that those tools process only <code>*.rst</code> files, not <code>*.py</code> files.</p>
  
  <p>My question is this: Can I use the DocUtils or Sphinx features of PyCharm to generate the API documentation?</p>
  
  <p>Failing that, can I use any features of PyCharm to do this?</p>
  
  <p>Failing that, are there any tools to do this that integrate well with PyCharm?</p>