DJC1 - Day 16 - Reaching One Million Active Users

DJC > Daily > DJC1

Using MkDocs for the Web

Create complete websites without writing a single line of HTML.

MkDocs is a lightweight and powerful tool for building websites from Markdown files. It helps you keep your content organized, versioned, and easy to update—ideal for documentation, technical blogs, or projects that require publishing content every day.

The best part is that you only write in Markdown, and MkDocs automatically turns everything into a fast, modern, production-ready website.

Here’s a real example of how to start a new MkDocs project:

mkdocs new my-site
cd my-site
mkdocs serve

What does this command do?

  • mkdocs new my-site → creates a ready-to-edit site structure.
  • cd my-site → enters the project directory.
  • mkdocs serve → starts a local server with automatic reload.

With this, you can already:

  • Create pages using only Markdown.
  • Add custom navigation from mkdocs.yml.
  • Use themes like Material for MkDocs for a professional design.
  • Publish your site with a single command on GitHub Pages or your hosting provider.

In my current workflow, MkDocs allows me to:

  • Organize daily content without clutter.
  • Create pages quickly without touching HTML or CSS.
  • Maintain clear versions for each day of the project.
  • Publish changes in seconds.

Versions

v0.1.0

  • Using MkDocs for the web

DJC > Daily > DJC1