
Security News
Deno 2.2 Improves Dependency Management and Expands Node.js Compatibility
Deno 2.2 enhances Node.js compatibility, improves dependency management, adds OpenTelemetry support, and expands linting and task automation for developers.
grunt-markdown
Advanced tools
This grunt task takes a set of markdown files and converts them to HTML. It supports GFM with code highlighting. The code highlighting is done using highlight.js.
Install this grunt plugin next to your project's grunt.js gruntfile with:
npm install grunt-markdown --save-dev
Then add this line to your gruntfile:
grunt.loadNpmTasks('grunt-markdown');
Creating a markdown task is simple. For the basic functionality add the following config in your gruntfile:
grunt.initConfig({
markdown: {
all: {
files: [
{
expand: true,
src: 'docs/src/*.md',
dest: 'docs/html/',
ext: '.html'
}
]
}
}
});
Here is an example config using all of the options:
grunt.initConfig({
markdown: {
all: {
files: [
{
expand: true,
src: 'docs/src/*.md',
dest: 'docs/html/',
ext: '.html'
}
],
options: {
template: 'myTemplate.jst',
preCompile: function(src, context) {},
postCompile: function(src, context) {},
templateContext: {},
contextBinder: false,
contextBinderMark: '@@@',
autoTemplate: true,
autoTemplateFormat: 'jst',
markdownOptions: {
gfm: true,
highlight: 'manual',
codeLines: {
before: '<span>',
after: '</span>'
}
}
}
}
}
});
These are the properties that the markdown
task accepts:
files
: This plugin supports use of the files API introduced in Grunt 0.4.0. Files may be specified using any one of the Compact Format, Files Objects Format, or Files Array Format (as in the above example).options
: options to be passed to the markdown parser
template
: If you wish to specify your own html template, use the template
option. Include the following line: <%=content%>
where you want the compiled markdown inserted in your templatemarkdownOptions
: Options passed directly to the markdown parser.preCompile
: is run before the markdown is compiledpostCompile
: is run after the markdown has been compiledtemplateContext
: the default context for template expansioncontextBinder
: this option is useful when we want to bind some parameters directly from markdown files. All data is stored in templateContext
object.contextBinderMark
: with this option we can pass any marker between which we can grab your special parameters from markdown templates.autoTemplate
: if this option is set to true, script will search for template automatically. Template must be placed in this same catalog where markdown files are.autoTemplateFormat
: the template format when autoTemplate
is true
.Sometimes there is a need to modify the markdown content prior to compilation. This is most commonly used to augment the template context with meta data before expanding the html template.
This function is run prior to the compilation of md to html. It has the following format:
function(src, context) {
//do stuff to src and context
//optionally return the modified src
}
This function is run after the md has been converted to html. It has the following format:
function(src, context) {
//do stuff to src and context
//optionally return the modified src
}
This object is used to expand your html template. Any data added to this object
will be available in the template using the template syntax <%=myAttr%>
.
This can also be a function which is expected to return a context object.
Most markdown options are passed as-is to the marked markdown parser. The only option that is processed prior to compiling the markdown is the highlight
option. If you specify 'auto' or 'manual' the task will handle highlighting code blocks for you using highlight.js. If you pass a custom function as the highlight option it will be used to highlight the code.
auto
: Will try to detect the languagemanual
: will pass the language name from markdown to the highlight functioncodeLines
: specify text that should wrap code linesBelow you can see example how to use this option.
markdown: {
all: {
files: [
{
expand: true,
src: 'docs/src/*.md',
dest: 'docs/html/',
ext: '.html'
}
],
options: {
template: 'myTemplate.jst',
preCompile: function(src, context) {},
postCompile: function(src, context) {},
templateContext: {},
contextBinder: true,
contextBinderMark: '@@@',
markdownOptions: {
gfm: true,
highlight: 'manual',
codeLines: {
before: '<span>',
after: '</span>'
}
}
}
}
}
Then inside markdown file we have to put: <!-- @@@key:value@@@ -->
and it will be equal to:
templateContext: {
key: 'value'
}
Copyright (c) 2012-2013 James Morrin Licensed under the MIT license.
FAQs
Compile markdown to html. GFM and code highlighting support!
The npm package grunt-markdown receives a total of 618 weekly downloads. As such, grunt-markdown popularity was classified as not popular.
We found that grunt-markdown demonstrated a not healthy version release cadence and project activity because the last version was released a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
Deno 2.2 enhances Node.js compatibility, improves dependency management, adds OpenTelemetry support, and expands linting and task automation for developers.
Security News
React's CRA deprecation announcement sparked community criticism over framework recommendations, leading to quick updates acknowledging build tools like Vite as valid alternatives.
Security News
Ransomware payment rates hit an all-time low in 2024 as law enforcement crackdowns, stronger defenses, and shifting policies make attacks riskier and less profitable.