mdBook
MkDocs
Our great sponsors
mdBook | MkDocs | |
---|---|---|
76 | 90 | |
12,311 | 15,828 | |
6.3% | 1.9% | |
8.2 | 9.5 | |
9 days ago | 8 days ago | |
Rust | Python | |
Mozilla Public License 2.0 | BSD 2-clause "Simplified" License |
Stars - the number of stars that a project has on GitHub. Growth - month over month growth in stars.
Activity is a relative number indicating how actively a project is being developed. Recent commits have higher weight than older ones.
For example, an activity of 9.0 indicates that a project is amongst the top 10% of the most actively developed projects that we are tracking.
mdBook
-
I made a browser extension that automatically applies themes on websites generated with mdBook.
I personally had the frustration that websites generated with [mdBook](https://github.com/rust-lang/mdBook) always displayed me the "Navy" theme. But I prefer the "Ayu" theme, therefore I always set the theme to "Ayu". But doing things per hand is not the way we do stuff around here, so I decided to write a small browser extension that applies the themes for me.
-
Are books underrated as a source for learning?
It's mdBook which is made in Rust and popular with Rust content https://rust-lang.github.io/mdBook/
- Self-hosted/opensource Help Center / CMS?
-
mdbook PDF generator with (optionally) no dependencies
I made a PDF generator for mdbook called mdbook-compress.
-
How to improve documentation / technical writing skills?
This makes me think, maybe I'll start using mdBook. I find it really comfortable to read and it's probably not too complicated to use.
-
Anyone use Git for writing projects?
I sync Obsidian with Git and use pandoc for book / ebook generation (or Foam with Visual Code might work too).
Scrivener can synchronise with Git too - albeit indirectly (it sync's with a folder & I use a simple script to keep it up to date)
If you need to organise research you can sync Wiki.js with Git.
However, Gitbook or mdBook might be easier to use for a single book project.
https://rust-lang.github.io/mdBook/
-
Wiki or a static website for homelab description
mdBook
-
Name a program that doesn't get enough love!
+1 for Pandoc. I'll also add mdBook as an alternate for markdown to web version of ebooks (especially for search and themes).
-
What’s the prettiest yet most lightweight self-hosted wiki service out there?
I also don't mind using a Markdown editor + static site generator like mdBook - BookStack is where I'd have gone if I wanted something else
-
New Rust course by Android: Comprehensive Rust 🦀
All credit goes to the mdbook people for this! I'm using it to turn Markdown text into HTML, complete with interactive playgrounds and all :-)
MkDocs
-
Self hosted personal wiki
I tried most of the above mentioned and settled down with MkDocs for its simplicity. It produces static web pages so you can easily host it with any web server.
-
How to deploy a static site using Mkdocs and Netlify
MkDocs is an open-source static site generator that is used to create documentation websites. It is written in Python and is built on top of the Jinja2 template engine. It uses Markdown files as the source for the documentation, and it generates a static HTML website that can be hosted on any web server.
-
Is it just me or is the quality of the Boost API docs just.. kind of terrible? Like compare it to cppreference (very good) or Qt docs (also great).
https://www.mkdocs.org/ is what they are using.
-
When did filelight transfer to QML?
Gitlab has implemented GitHub Pages feature, so KDE can do this. I don't know enough about Meson, but I have used MKDocs to generate websites for Node.js and Python projects.
-
Markdown, Asciidoc, or reStructuredText - a tale of docs-as-code
Configured with a single YAML file, MKDocs is the fourth Markdown framework on my list, which falls in the category of SSG. Although there are not as many as in Hugo, MKDocs offers a few official themes and a number of third party themes. As a Python-based framework, you can use pip to install MKDocs plugins. You can follow this getting started guide for your first MKDocs project.
-
Starlite development updates January ’23
The second biggest one will be moving away from mkdocs and to Sphinx. During the process of the documentation overhaul, it has become clear that, while a great tool, mkdocs simply is not fit for the purpose of providing well structured, larger scale documentation. It definitely has its merits, and I would absolutely recommend it for someone looking for a simple tool to write not to complex docs, but if it's going to be more involved, mkdocs' shortcomings will catch up with you at some point.
-
Formatting my writing samples for a WordPress site...
You could try MkDocs, upload to GitHub, and host with GitHub Pages. This also allows you to use HTML and CSS if you want to customise the theme, and you can use Markdown for formatting any docs.
-
Kreiranje online wiki sto bi sacuvali
Mkdoks
-
Ask HN: What platform/tool do you use for software documentation?
Other people mentioned code comments and Markdown files, I'm inclined to agree.
I've used code comments pretty well to explain both non-trivial technical details, as give a quick rundown of business requirements that are the basis for some code existing, maybe with links back to an issue tracking system where more context is needed. Markdown files are better if you want to include images/videos/animations/diagrams and provide more context, or step by step instructions on how to do something, which is great because you can easily search through them, as they're just text. Code can typically explain what it does itself but not necessarily why, so it's great to have either of the tools at your disposal.
Of course, there's nothing wrong with external Wikis either, though some are implemented better than others IMHO.
Confluence is sometimes the only choice you get, so having it is better than having nothing.
GitLab and GitHub also have integrated Wikis, as do other solutions: https://docs.gitlab.com/ee/user/project/wiki and https://docs.github.com/en/communities/documenting-your-proj...
For ones to host separately, I've found BookStack to be pretty good in its simplicity/usability/performance: https://www.bookstackapp.com/
As for other solutions that are meant specifically for documentation, Read the Docs might be of appeal to some: https://readthedocs.org/
You can probably also use Sphinx (used by Flask): https://www.sphinx-doc.org/en/master/ or MkDocs: https://www.mkdocs.org/ or something else entirely.
- Expose markdown files in web interface
What are some alternatives?
sphinx - The Sphinx documentation generator
DocFX - Static site generator for .NET API documentation.
Hugo - The world’s fastest framework for building websites.
pdoc - API Documentation for Python Projects
Docusaurus - Easy to maintain open source documentation websites.
Read the Docs - The source code that powers readthedocs.org
BookStack - A platform to create documentation/wiki content built with PHP & Laravel
gitbook - 📝 Modern documentation format and toolchain using Git and Markdown
Pycco - Literate-style documentation generator.
VuePress - 📝 Minimalistic Vue-powered static site generator
Wiki.js - Wiki.js | A modern and powerful wiki app built on Node.js