conf.py

import sys
import os

sys.path.insert(0, os.path.abspath('..'))
#import recommonmark
from recommonmark.parser import CommonMarkParser
from recommonmark.transform import AutoStructify

source_parsers = {
    '.md': CommonMarkParser
}

source_suffix = ['.rst', '.md']

html_static_path = ['_static']

master_doc = 'index'
project = u'MacAdmins Community Documentation'
copyright = u'CC BY-SA 4.0'
github_doc_root = 'http://github.com/Shufflepuck/MacAdminsDoc/tree/master/'

html_context = {
    "display_github": True, # Integrate GitHub
    "github_user": "Shufflepuck", # Username
    "github_repo": "MacAdminsDoc", # Repo name
    "github_version": "master", # Version
    "conf_py_path": "/", # Path in the checkout to the docs root
}

# app setup hook
def setup(app):
    app.add_stylesheet("extra.css")
    app.add_config_value('recommonmark_config', {
            'url_resolver': lambda url: github_doc_root + url,
            'auto_toc_tree_section': 'Contents',
            }, True)
    app.add_transform(AutoStructify)