LinuxCommandLibrary

mkdocs

generates documentation websites

TLDR

Create new project

$ mkdocs new [project-name]
copy
Serve locally
$ mkdocs serve
copy
Build site
$ mkdocs build
copy
Deploy to GitHub Pages
$ mkdocs gh-deploy
copy
Serve on custom port
$ mkdocs serve -a [localhost:8080]
copy
Strict mode
$ mkdocs build --strict
copy

SYNOPSIS

mkdocs command [options]

DESCRIPTION

mkdocs generates documentation websites. It builds static sites from Markdown files.
The tool is designed for project documentation. Supports themes and plugins.

PARAMETERS

COMMAND

MkDocs operation.
new NAME
Create new project.
serve
Start dev server.
build
Build static site.
gh-deploy
Deploy to GitHub Pages.
-a ADDR
Server address.
--help
Display help information.

CAVEATS

Python-based. Requires mkdocs.yml config. Material theme popular.

HISTORY

MkDocs was created to provide simple, fast documentation generation from Markdown files.

SEE ALSO

sphinx-build(1), jekyll(1), hugo(1)

> TERMINAL_GEAR

Curated for the Linux community

Copied to clipboard

> TERMINAL_GEAR

Curated for the Linux community