Skip to content
Snippets Groups Projects
index.md 4.04 KiB

MkDocs

Project documentation with Markdown.

MkDocs is a fast, simple and downright gorgeous static site generator that's geared towards building project documentation. Documentation source files are written in Markdown, and configured with a single YAML configuration file. Start by reading the introductory tutorial, then check the User Guide for more information.

Day Breakfast Lunch Dinner
Monday Avocado Toast & Coffee Grilled Chicken Salad Spaghetti Carbonara
Tuesday Greek Yogurt & Berries Tuna Sandwich Grilled Salmon
Wednesday Oatmeal & Green Tea Chicken Caesar Wrap Stir-Fry Vegetables
Thursday Scrambled Eggs & Toast Vegetable Soup Beef Stroganoff
Friday Pancakes & Orange Juice BLT Sandwich Margherita Pizza
Saturday French Toast & Smoothie Chicken Quesadilla BBQ Ribs
Sunday Bagel & Cream Cheese Steak Salad Roasted Chicken & Veggies

  1. Section 1
  2. Section 2

Section 1

Content for section 1

Features

Great themes available

There's a stack of good looking themes available for MkDocs. Choose between the built in themes: mkdocs and readthedocs, select one of the third-party themes listed on the MkDocs Themes wiki page, or build your own.

Easy to customize

Get your project documentation looking just the way you want it by customizing your theme and/or installing some plugins. Modify Markdown's behavior with Markdown extensions. Many configuration options are available.

Preview your site as you work

The built-in dev-server allows you to preview your documentation as you're writing it. It will even auto-reload and refresh your browser whenever you save your changes.

Host anywhere

MkDocs builds completely static HTML sites that you can host on GitHub pages, Amazon S3, or anywhere else you choose.

Section 2

Content for section 2