Ben Chuanlong Du's Blog

It is never too late to learn.

Tips on mkdocs

Things on this page are fragmentary and immature notes/thoughts of the author. Please read with your own judgement!

https://github.com/mkdocs/mkdocs

https://pypi.org/project/mkdocs-blog-plugin/

https://ddrscott.github.io/blog/2018/move-to-mkdocs/

https://github.com/danielfrg/mkdocs-jupyter

Markdown vs RestructureText vs MyST for Documentation

Things on this page are fragmentary and immature notes/thoughts of the author. Please read with your own judgement!

Comparison

  1. Compared to Markdown, RestructuredText is more fully-featured, much more standardized and uniform, and has built-in support for extensions. However, ReStructuredText is also criticized for its complex and confusing syntax. The …