Skip to content

j3soon/mkdocs-material-template

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

51 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

MkDocs Material Template

This is a template based on Material for MkDocs.

Click here to preview!

The template features:

If you like this template, consider sponsoring @squidfunk for his amazing work. As a sponsor, you'll gain access to additional Insider features.

Getting started

  1. Fork this Git repository
  2. Search for TODOs in the forked repository and modify accordingly to customize your site.

Please make sure to fork the repository (or at least keep the Git commit history), since it allows you to merge in future updates from the template easily.

Run Locally

  1. Clone the repository (or your forked repository):

    cd ~
    git clone https://github.com/j3soon/mkdocs-material-template.git
    cd mkdocs-material-template
  2. (Optional) Set up a virtual environment:

    virtualenv venv -p python3
    source venv/bin/activate

    Make sure to run the source command every time you open a new terminal.

  3. Install dependencies:

    pip install -r requirements.txt
  4. Preview the site (supports hot reload on save):

    mkdocs serve

    Go to https://127.0.0.1:8000 to view the site.

  5. (Optional) Build the site:

    mkdocs build

    The site will be built to the site directory.

Releases

No releases published

Packages

No packages published

Languages