Install

Getting started with SassDoc could not be any easier.

npm install sassdoc -g

Comments

Write SassDoc compliant comments. The syntax is pretty close to JSDoc’s although we took some liberty with it.

SassDoc command

sassdoc <src>... [options]
sassdoc - [options]

… where:

  • <src> is the path to one or more Sass folders or glob expressions to SCSS/Sass files; if - is given instead, SassDoc will read from stdin;
  • [options] are the options.

Options

Option Role
-h, --help Bring help.
--version Show version.
-v, --verbose Enable verbose mode.
-d, --dest Documentation folder [default: sassdoc].
-c, --config Path to JSON/YAML configuration file.
-t, --theme Theme to use.
-p, --parse Parse the input and output JSON data to stdout.
--no-update-notifier Disable update notifier check.
--strict Turn warnings into errors.
--debug Output debugging information.

Profit

Open the index.html file generated in the sassdoc directory (or the path you gave to --dest). It should contain your documentation! What about configuring and customising the view a little bit now?