About six months ago I had the experience of converting a document of that size or a bit bigger from markdown to rST with sphinx. I used pandoc: pandoc --from=markdown --to=rst <filename-base>.md -o <filename-base>.rst I created a blank sphinx project and then manually hooked up the converted rst pages into the main table of contents. I had to do lots of manual cleanup afterwards. The main things were that I had to fix the table formatting, and that I had to put in sphinx-style internal references. (http://www.sphinx-doc.org/en/stable/markup/inline.html#cross-referencing-arbitrary-locations) David H On Thursday, June 14, 2018 6:34am, "Renato Pontefice" <[email protected]> said:
Hi I've build a little manual (about 25 pages) using the markdown language. All the doc are in a repository (GitHub) I'm wondering if is it possible to import it and use it with sphinx because I want to leave markdown and start rst with sphinx. Any sudgestion? TIA Renato-- 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 [ [email protected] ]( mailto:[email protected] ). To post to this group, send email to [ [email protected] ]( mailto:[email protected] ). Visit this group at [ https://groups.google.com/group/sphinx-users ]( https://groups.google.com/group/sphinx-users ). For more options, visit [ https://groups.google.com/d/optout ]( https://groups.google.com/d/optout ). -- 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 [email protected]. To post to this group, send email to [email protected]. Visit this group at https://groups.google.com/group/sphinx-users. For more options, visit https://groups.google.com/d/optout.
