RAML to Markdown
A simple RAML to Markdown documentation generator, written for Node.js. Check raml2html for a RAML to HTML generator.
RAML version support
raml2md 4 and higher only support RAML 1.0 files. Please stick with raml2md 3.x for RAML 0.8 support.
Install
npm i -g raml2md
Usage
As a command line script
raml2md example.raml > example.md
raml2md -i example.raml -o example.md
raml2md -t examples/custom-template-test/template.nunjucks -i examples/example.raml -o example.md
As a library
Using the default templates
var raml2md = ;var config = raml2md; // source can either be a filename, file contents (string) or parsed RAML object.// Returns a promise.raml2md;
Using your own Nunjucks templates
var raml2md = ;var config = raml2md;raml2md;
Custom pre-processing
var raml2md = ;var config = raml2md; config { // Do whatever you want here and return the modified data. // The default implementation: return data;}; raml2md;
If you want to use a different template language, you're better off directly using raml2obj.
RAML version support
raml2md 4 and higher only support RAML 1.0 files. Please stick with raml2md 3.x for RAML 0.8 support.
Contribute
raml2md is an open source project and your contribution is very much appreciated.
- Check for open issues or open a fresh issue to start a discussion around a feature idea or a bug.
- Fork the repository on Github and make your changes on the develop branch (or branch off of it).
Please retain the code style that is used in the project andnpm run lint
before committing. - Add an example of the new feature to example.raml (if applicable)
- Send a pull request (with the develop branch as the target).
A big thank you goes out to everyone who helped with the project, the contributors and everyone who took the time to report issues and give feedback.
License
raml2md is available under the MIT license. See the LICENSE file for more info.