Open anibali opened 11 months ago
Thanks for opening your first issue here! Engagement like this is essential for open source projects! :hugs:
If you haven't done so already, check out EBP's Code of Conduct. Also, please try to follow the issue template as it helps other community members to contribute more effectively.
If your issue is a feature request, others may react to it, to raise its prominence (see Feature Voting).
Welcome to the EBP community! :tada:
What version of
myst-parser
are you using?2.0.0
What version dependencies are you using?
What operating system are you using?
Linux
Describe the Bug
Consider the use case of including headings in top-level module docstrings. For example:
Now suppose that there are multiple modules with the same headings in their docstrings. If we attempt to document these modules by using
automodule
from separate markdown files (viaeval-rst
), we get "WARNING: duplicate label [...]". This seems to only affect "top-level" headings (e.g., "Introduction" in the above snippet, but not "More"). This warning does not occur when usingautomodule
from.rst
files instead of.md
files.Expected Behavior
There should be no "duplicate label" warning.
To Reproduce
sphinx-build docs build/html
To see how this issue does not affect
.rst
files, convert bothmyproj_bar.md
andmyproj_foo.md
to restructured text. For example, renamemyproj_bar.md
tomyproj_bar.rst
and change its content to: