LinuxCommandLibrary

docsify

dynamic Markdown documentation site generator

TLDR

Initialize new documentation site

$ docsify init [./docs]
copy
Start local preview server
$ docsify serve [./docs]
copy
Serve on specific port
$ docsify serve [./docs] --port [4000]
copy
Generate sidebar automatically
$ docsify generate [./docs]
copy
Serve with live reload
$ docsify serve [./docs] --livereload-port [35729]
copy

SYNOPSIS

docsify command [options] [path]

DESCRIPTION

docsify is a documentation site generator that dynamically renders Markdown files without building static HTML. It loads and parses Markdown files on the fly, providing instant updates during editing.
The tool creates simple, elegant documentation websites from Markdown files. Features include full-text search, multiple themes, plugin support, and GitHub Pages compatibility. Configuration is minimal, typically just an index.html and Markdown files.
docsify is particularly suited for project documentation, requiring no build step and supporting features like cover pages, sidebars, and embedded code samples.

PARAMETERS

COMMAND

Operation: init, serve, generate.
PATH
Documentation directory.
init [PATH]
Initialize new docsify project.
serve [PATH]
Start local server.
--port N
Server port (default: 3000).
--livereload-port N
Live reload port.
--open
Open browser automatically.
--help
Display help information.

CAVEATS

Requires JavaScript for rendering (no static HTML). SEO may be affected by client-side rendering. Large documentation sites may have initial load delay.

HISTORY

docsify was created by cinwell and released as an open-source project. It gained popularity as a lightweight alternative to documentation generators like GitBook and VuePress, emphasizing simplicity and no build requirements.

SEE ALSO

mkdocs(1), vuepress(1), gitbook(1)

> TERMINAL_GEAR

Curated for the Linux community

Copied to clipboard

> TERMINAL_GEAR

Curated for the Linux community