A magical documentation site generator.
Being easy to use is one of our core principles. First, you need to install
docm docm-theme-default on your project using some package manager (we're assuming Yarn here):
$ yarn add docm docm-theme-default --dev# use npm$ npm install --save-dev docm docm-theme-default
After you installed
docm docm-theme-default in your project, you may find it convenient to add two scripts in your
package.json to run docm for you. This is an optional step:
Now you can spin up your dev server just by running:
$ yarn docm:dev
With your dev server up, you can start writing your documentation.
Docm uses MDX as a standard format because of the flexibility of writing JSX inside markdown files. Really cool, no?
Note that you don't need to follow any strict file architecture. You can just create your
.mdx files anywhere in your project.
So, let's create our first
.mdx and give it a name:
---name: Hello world---# Hello worldHello, I'm a mdx file!
Now, just run your dev server:
$ yarn docm dev
With the server up and your first
.mdx created, you can open your browser and visit
localhost:3000 and you should see something.
That's it! Now you have a real badass documentation 👊
Now that you know how to get started with docm, see the docs where we'll delve into MDX and how you can use it to write your documents.
Bug Reports or Feature Requests
Please use GitHub Issues.
Please use GitHub Pull Requests.
I'm not familiar with English, so I especially thank you for documents' corrections.