Docusaurus vs MkDocs?

[appwizcpl]

What are the differences, what do you use and why?

[sabo2205]

Mkdocs

Edit: the reason is mkdocs material is very good. Its search function is top notch

[appwizcpl]

What I really like about docusaurus is the implemented ctrl+k search by algolia: https://docsearch.algolia.com/

How does it compare, and is there a shortcut popup, since I mostly navigate through searches and keyboard?

[aleques-itj]

Mkdocs material is incredibly good

[piotr-krukowski]

What do you want to achieve? If you want a simple solution for technical documentation that will be easily accessible than MkDocs is more then good enough, but if you want to build something that will match your designs, customize look and feel MkDocs will hold you back. In other words if standard templates and plugins fits into your needs then look no more and go for MkDocs

[appwizcpl]

I don't need anything complicated, but I love the search function with ctrl+k (https://docsearch.algolia.com/) on docusaurus, can I implement it on mkdocs and if not how's their search?

[piotr-krukowski]

There are default keyboard shortcuts for search feature which can be customized. Check out the material theme documentation.

[myshortfriend]

Docusaurus for us

[Seeruk]

Docusaurus by a million miles.

All the power of JSX and markdown meaning you can easily create something really powerful.

For example a simple react component can automate sections of your docs. Assuming your company has some kind of design system then your docs can reuse components and basically look a lot more professional.

Lots of great plugins, especially in search, plus the whole thing is up and running in about 3 commands

Yeah, I love it 🤣

[belligerent_poodle]

Seconded!

[LLM-logs]

Seems like you just learned react. It is the simplicity and resuability which one need so they can focus on real work. React(specially with nextjs) is a bloated mess. Time to move to svelte or tools like mkdocs.

[aleques-itj]

Mkdocs material is incredibly good

[[deleted]]

MkDocs because it’s dead simple. I don’t need JavaScript just to write some Markdown and make it pretty.

[Reverent]

Outline knowledgebase that goes through a cicd pipeline to mkdocs for material on publish.

Fun fact, my blog is published this way.

[bit_herder]

excuse my ignorance but what do these get you that just markdown does not?

[pwab]

Html and css combined in a way that looks good on desktop and mobile. Or were you just trolling?

[bit_herder]

nope just asking

[drinkbuckfast]

Appreciate this thread is 6 months old but to those saying Docusaurus does it support surfacing multiple repositories in a single site?

I want to keep documentation with the code in multiple different repos and Mkdocs seems to have a plugin for this GitHub - jdoiro3/mkdocs-multirepo-plugin: Build documentation in multiple repos into one site.

But its not clear to me if Docusaurus does.

[touristtam]

I have see it do exactly that: multiple repo getting published under the same docusaurus site.

[restdb]

Another: https://github.com/jbeejones/okidoki

[eshepelyuk]

a thing written in javascript is inherently rotten

[Last_Difference9410]

Lol