search

readthedocs / recommonmark

A markdown parser for docutils
https://recommonmark.readthedocs.io/
MIT License
340 stars 252 forks source link

multiple titles can not be overridden #182

Closed LucidOne closed 2 years ago

LucidOne commented 5 years ago

Given a README.md

# project name

## blah
foo

# note
blah blah blah

and an index.rst

.. toctree::
   :maxdepth: 2
   :caption: Contents:

   README <README>

The document title can't be overridden in the toctree and there is no warning as to why. Moving # note to a level 2 heading ## note allows the title to be overridden.