Syntax Highlighting in Markdown

[IngwiePhoenix]

It would be nice if we wouldn't need to drop HighlightJS into our static files, and instead can have it pre-rendered already.

HLJS takes up a big bit of data. So it'd be nice if you could allow people to preprocess syntax highlight-able blocks during compilation.

[IngwiePhoenix]

Any news on the issue here?

[sliminality]

@IngwiePhoenix I still need to write tests but plan on opening a PR within a couple days. In the interim, you can implement this easily in your local Harp installation (technically Terraform, since that's what manages Harp's asset pipeline).

From Harp's package directory, checkout a new branch, install and save the highlight.js package from npm, and then modify node_modules/terraform/lib/template/processors/md.js by replacing the first line with the following:

var marked = require("marked").setOptions(
  {
    langPrefix: 'language-',
    headerPrefix: '',
    highlight: function (code) {
      return require('highlight.js').highlightAuto(code).value;
    }
  })

You'll still need to include the Highlight.js CSS file in your layout template, but this should take care of the pre-processing.

[IngwiePhoenix]

Including the Highlightjs CSS is no biggie - its really small, so that works well for me.

Glad to hear you picked this up! Looking forward to the PR. :)

[kennethormandy]

We do have this existing PR, which would be nice to get a second opinion on. I think this would be a valuable addition to Terraform, but we never really got a chance to discuss it yet. In the meantime, Prism is also a really nice client side option, too.