Markdown module recommendations

Python Help
1

We’d like to add Markdown support to our open source project, but the problem is that there are multiple alternatives:

All these projects seem to be actively maintained and, at least based on GitHub stars, none is hugely more popular than others. Has anyone here happened to evaluate these and possible other alternatives? Or do you have positive/negative experience from using some of them?

We don’t have that special needs otherwise, but being able to vendor the module would be good. We try to avoid mandatory dependencies to keep installation easy on systems without Internet connection, and I wouldn’t like Markdown documentation support to be an optional feature.

1 Like
2

Since no one ever responded here, can I ask which package you ended up going for, what sources/factors influenced that decision, and what your experience has been?

2 Likes
3

I don’t do a ton with markdown. This package has worked fine for me. That corresponds to the first GitHub item in @pekkaklarck’s list.

2 Likes
4

We haven’t actually yet added Markdown support to our project, it’s in the scope of the next release, so I don’t have extensive experience from things like vendoring. That said, I’ve lately worked with Mkdocs that uses Python Markdown (first item in the list, also mentioned by @smontanaro) and haven’t had any problems. It has had extensions for all our general needs and I was also able to solve one special need with a custom extension. Because I now have some experience with Python Markdown, I plan is to use it when we start adding Markdown support to our project and only look at alternatives only if there are problems.

1 Like