Sign Up for Free

RunKit +

Try any Node.js package right in your browser

This is a playground to test code. It runs a full Node.js environment and already has all of npm’s 400,000 packages pre-installed, including gulp-raml2html with all npm packages installed. Try it out:

var gulpRaml2html = require("gulp-raml2html")

This service is provided by RunKit and is not affiliated with npm, Inc or the package authors.

gulp-raml2html v0.3.0

A simple RAML to HTML documentation generator.

gulp-raml2html is back in the game. But you can still help us by submitting PRs on develop branch. Thanks in advance!`


Build Status NPM version Dependency Status devDependency Status

A simple gulp plugin to automate the process of generating HTML documentation based on a RAML API.

If you have any difficulties with the output of this plugin, please use the raml2html tracker.

Note: This plugin wraps raml2html.



npm install gulp-raml2html --save-dev


gulp basis

Gulp is a build life-cycle tool. You can configure several tasks to be ran when entering gulp [taskname] in your console ('default' task is invoked if not specified). It can also be invoked by Continuous Integration tools. To be able to use it, your application must have a gulpfile.js with the possible tasks configured.

A typical gulpfile.js will start with:

var gulp = require('gulp');
var raml2html = require('gulp-raml2html');

Add HTML generation task

// your existing tasks
gulp.task('apidoc', function() {
  return gulp.src('api.raml')
// more tasks


gulp apidoc will grab api.raml and generate a build folder with the generated HTML on it.


Included in this repository. Click here to go to the "example" folder



Type: boolean Default value: false

When set to true it also takes JSON files as input (generated by the RAML parser).


Type: boolean Default value: false

When set to true the raml2html generator will output links to the all assets over https protocol.


The code for gulp-raml2html is licensed under the MIT license. See license.txt file for more info.


RunKit is a free, in-browser JavaScript dev environment for prototyping Node.js code, with every npm package installed. Sign up to share your code.
Sign Up for Free