docsify VS Docusaurus

Hello, FYI: I used https://docsify.js.org/ that turns markdown files into a static website without the need of building the site locally or in a CI. Example config. my 2c.

After reading your post again and this comment, I don't think Jekyll is the best choice. Something like GitBook, MkDocs, or Docsify would be a better solution as they let you control the organization and flow much better.

Docsify

On a new side project I'm working on I need to have a fair amount of documentation for usage, implementation, options, etc. In the past I've used https://docsify.js.org hosted on Vercel, but I was curious if there is anything else out there people like. Looking for free or paid options. So long has I can host on a subdomain I'm indifferent.

Thanks!

Docsify is a client-side only documentation generator. As a user requests a documentation page, it would fetch the associated .md file and render it all client-side. That meant that our documentation deployment process was simple again, as we could just push changes to the main branch and BOOM they would show up within seconds.

+1 more for Docsify and its Github repo. I know this subreddit is for self-hosted things, however I wanted to add Docsify works well with Github Pages (they host, you plug in your domain or subdomain).

https://docsify.js.org/#/ SSGs are too complicated.

Looking for recommendations for an open-source tool to build your resume. I'm wondering if there's anything similar to Docusaurus that allows you to maintain your resume as code. Thanks!

We originally created our documentation for a very small, specific audience with specific uses for Courier. Over time, however, our user base, their use cases, and our product itself has grown dramatically. To cover our bases, we needed to improve and expand our documentation and this time, we wanted to make it scalable and with a focus on a great user experience. We decided to use Docusaurus to do so, which allowed our engineers to collaborate and update our documentation more efficiently. Here’s how we built our documentation and what we learned in the process that might be useful to you.

Docusaurus is a commonly-used static site generator that’s aimed at software documentation, and it produces very nice (and highly customizable) websites.

So here it is - a blog post on how we can create a content-focused static website with Docusaurus and deploy it using Azure Static Web Apps. Want to get a sense of what kinds of static sites you can build with Docusaurus? Check out their showcase!

mdx is great, especially if your team is already fluent with react/jsx. You might also be interested in docusaurus https://docusaurus.io/ as it has support for mdx built in.

You should check out Docusaurus. It is a site generator mainly used to create documentation websites created with React.

Docusaurus (279 active contributors).

I used https://docusaurus.io for my website and later also for my saas landing and documentation too. I think it's great for static content written in markdown files.

It started with a very simple setup. Two github repositories: One for our backend, which included OpenAPI specs of our backend APIs. The second for our documentation website, which we based on Facebook's Docusaurus.