reST&markdown hybrid project possible ?

[Wolf Drechsel]

Hello,

I'm new to this group. Happened to be part of a documentation project in sphinx, the guys who started it already did ~50% in reST. I now should deliver the remaining 50%, but I'm very much used to markdown and not so eager to learn reST.

Is it possible to conduct this project as a hybrid:

I'm contributing my markdown bits, the other fellows continue using reST? -

In case: How could that be done?

Cheers, Wolf

[Kevin Cole]

Pandoc is your friend here:

https://pandoc.org/

Write in whatever you like -- in your case, Markdown, and convert to whatever you like later -- e.g. reStructuredText.

--

Physical

Kevin Cole, RHCE

("ubuntourist")

Brain-Washington,

Disenfranchised City

Virtual

Git:	https://codeberg.org/ubuntourist/
CV:	https://stackoverflow.com/cv/ubuntourist/
LinkedIn:	https://linkedin.com/in/ubuntourist/
GPG Key ID:	0x3E696927

[Juan Luis Cano Rodríguez]

You can also use something like MyST-Parser https://myst-parser.readthedocs.io/, a Sphinx extension that will take care of your `.md` bits. That way, you can keep the `.rst` ones, and add new docs in MyST. Sphinx will read both without problems.

Cheers,

jua...@readthedocs.org

Read the Docs

--
You received this message because you are subscribed to the Google Groups "sphinx-users" group.
To unsubscribe from this group and stop receiving emails from it, send an email to sphinx-users...@googlegroups.com.
To view this discussion on the web visit https://groups.google.com/d/msgid/sphinx-users/71a6ab1b-49f7-45de-a9c5-30308f403e84n%40googlegroups.com.

[Wolf Drechsel]

Hello, thank you very much for your time, this looks promising. I'll check it out with our Sphinx experts.

Cheers, Wolf