devportal VS markdown-live-preview

Hello folks, I am running a tech writing team (along with product management). I am not expert in documentation platforms. Today we have a challenging custom-built documentation platform based on Sphinx and a bunch of cobbled together technologies aiven/devportal: Resources for users of the projects on the Aiven platform (github.com) . Our documentation is in .rst markup language due to the Python focus.

Humble brag that the last one in the list (Aiven 🦀) won 2022 DevPortal Awards in the category Best DevPortal Beyond REST Platforms. If I added a list of great docs websites but didn't include the OG, it would be a crime. Check out one of THE BEST documentation out there - Stripe Docs, built using Markdoc.

You can find a list of Aiven's cloud providers on [Developer.aiven.io], which is also the portal where we host the developer documentation. To quickly retrieve a list of currently-available cloud providers, my colleague Lorna Mitchell wrote a Python script that pulls our cloud listing from the Aiven API and generates documentation, which is really cool!

If you want to try out play with Markdown Language - click here: https://markdownlivepreview.com/

A while ago i make myself a list of possible ways to make a GUI (im not formatting it to reddit-specific markdown, sorry, paste the following text in https://markdownlivepreview.com/ or something if its not readable) :

You can use the "Markdown Live Preview" tool to look at the page format of any Markdown files.

dillinger or markdownlivepreview

If you're just starting out with Markdown, check out the syntax and write some hello-world docs online.

I'd recommend using a Reddit comment preview tool before posting. Like this one: https://markdownlivepreview.com/

Solved ! I just need to clone https://github.com/tanabe/markdown-live-preview and run script and voila, offline markdown editor and preview on qutebrowser.