Sphinx with Markdown !!

README.rst

Limitations

CommonMark-py supports syntax of CommonMark. So, CommonMark-py doesn't support sphinx/reST role and directives.

References

• ReCommonMark doc sample
• Sphinx Chat
• Sphinx Ticket (Markdown capable Sphinx #825)
• [sphinx-users] generating documentation from both reST and non-reST?
• CommonMark ticket (Generic directives/plugins syntax)

conf.py

source_parsers={
  '.md': 'recommonmark.parser.CommonMarkParser'
}
source_suffix=['.rst','.md']

install.sh

pip install Sphinx recommonmark