HACKER Q&A
📣 stuartjohnson12

Visual interfaces for editing markdown-based static sites?


I rolled out a very nice Docusaurus-powered handbook at the startup where I work inspired by Posthog's but it has been swiftly sent to the graveyard as non-technical folks don't feel empowered to add to it. I don't really have a good answer, and bafflingly from searching it seems like the only choices are to roll up a heavy CMS integration which I don't think people would be happy with me if I spent the time on.

Any alternatives that don't mean I have to abandon it?

It feels like there's a gaping hole in the toolchain here for JAMstack

  👤 codegeek Accepted Answer ✓
Try tina cms https://tina.io

Currently testing it with Docusaurus for our documentation site.

Edit: They have an integration with Docusauruas already here:

https://github.com/tinacms/tinasaurus

👤 Leftium
I built a prettifier for Google Forms: https://gg.leftium.com/pretty

Based on non-technical peoples' convention of using Google Forms to create sign-up pages (and even purely informational pages) like this: https://forms.gle/y2JF9RKipWcDWupP7

My prettifier supports markdown syntax, but Google Forms also supports WYSIWYG editing.

There's even a Google-sheets based router for building a simple site with navigation:

- https://docs.google.com/spreadsheets/d/1uFQ8W20dkHr01KB_zaoU...

- https://gg.leftium.com/

Open-source: https://github.com/Leftium/cloud9dancehall.com

👤 joegahona
OP: Please update this if you find an answer. I just rolled out a Docusaurus-powered documentation site myself — my first persona is developers, so getting them to update Markdown isn’t too much to ask, but in 2024 I plan to expand the scope of the site to include product managers, program managers, and even chiefs-of-staff and executive assistants, so this will be top of mind for me. This is exactly how things like Confluence and even Google Docs (or Slides!) crop up and take hold. Those tools aren’t evil per se but they’re not ideal for developer documentation.
👤 slorber
Docusaurus maintainer here

I agree the md editing story for non-dev contributor is not great.

You can try a git based CMS like Tina, they have a Docusaurus starter/example.

StackBlitz web publisher is also a good solution, allowing you to run Docusaurus directly in the browser in a very simple interface allowing you to commit or send PRs easily. No need to install nodejs locally, and you get a real preview.

👤 solardev
(Disclaimer: I work for one of these)

This is the niche that headless CMSes excel in. Your editors get an easy to use GUI (vendor or self hosted, though IMO the commercial ones are nicer and easier to use). Your developers get JSON and Markdown.

You can also use WordPress with Advanced Custom Forms to accomplish something similar in an hour or two.

👤 slorber
Wonder if it's not possible to use this dark matter product (normally for Astro) with Docusaurus worth giving it a try https://getdarkmatter.dev/
👤 KeithBrink
You can look into a Git-based CMS, such as https://github.com/decaporg/decap-cms

These typically are designed to support static site generators.

👤 skydhash
I feel it would be better to just roll out a google doc as a living documents, and publish a pdf or html version as the official document.

I used StackEdit for a while, but it still requires to know the markdown syntax.

👤 bosky101
Self hosted outline is exactly what you need

https://github.com/outline/outline