Ich verwende Sphinx für die Dokumentation eines Python-Projekts und hätte gerne den Inhalt einer vorhandenen .md -Datei in einer .rst -Datei.
(Ich habe meine conf.py bereits eingerichtet, um Abschläge zuzulassen).
Zum Beispiel habe ich eine Datei namens tutorial.md . Ich habe auch eine .rst -Datei wie folgt:
Ich möchte einen Link zu tutorial.md wie folgt einfügen, so dass der Inhalt von tutorial.md beim Rendern in der Datei angezeigt wird. Dies kann mit folgendem erreicht werden:
Der resultierende Inhalt sieht jedoch schlecht aus, da der Markdown nicht als Markdown dargestellt wird.
Mir ist klar, dass ich dieses Problem vermeiden kann, indem ich die gesamte Dokumentation als .md schreibe, aber diese Übung hat mich mit folgender Frage zurückgelassen:
Ist es möglich, .md content render als Markdown, innerhalb einer .rst Datei zu haben?
Tags und Links python-sphinx markdown documentation restructuredtext