January 18, 2019

328 words 2 mins read

ryanflorence/render-markdown-javascript

ryanflorence/render-markdown-javascript

Renders markdown files to HTML with highlighted code blocks BUT ALSO RENDERS THE JAVASCRIPT ONES.

repo name ryanflorence/render-markdown-javascript
repo link https://github.com/ryanflorence/render-markdown-javascript
homepage
language JavaScript
size (curr.) 677 kB
stars (curr.) 412
created 2017-09-04
license

Render Markdown JavaScript

Renders markdown files to HTML with highlighted code blocks BUT ALSO RENDERS THE JAVASCRIPT ONES.

screenshot

Why?

I’ve got a bunch of little JavaScript UI libs that don’t need much more than a README.md for documentation, but a demo is worth a thousand README.md’s, so I’d like the code in the README.md to actually render in a browser. Also great so people can copy/paste from the docs and know that it runs.

How?

Write normal markdown but for code fence blocks you want to have render in the browser also, use the “render” or “render-babel” language. Github markdown hates code fenced blocks inside of code fenced blocks, so I don’t have an example here, look at the demo.md

How do I get JavaScript and CSS onto the page?

With <script>, <link>, and <style> of course.

<script src="https://unpkg.com/react@15.6.1/dist/react.js"></script>
<script src="https://unpkg.com/react-dom@15.6.1/dist/react-dom.js"></script>
<link rel="stylesheet" type="text/css" href="https://unpkg.com/purecss@1.0.0/build/pure-min.css"/>
<style>body { color: red }</style>

# Then markdown as usual...

You can place your scripts at the bottom of the markdown file to prevent blocking your content from rendering, all scripts are run after DOMContentLoaded.

Also check out the demo.md file from the screenshot.

Does it babel?

Yes, first include babel standalone at the top of your markdown file and then use the render-babel language instead of render. Again, github hates code fence blocks inside code fence blocks here so I can’t really show you in this README. Check out the demo

How Do I Attach Stuff to the DOM?

There will be a variable called DOM_NODE available to use, its the node for just that script.

CLI Usage

npm install render-markdown-js
render-markdown-js ./some-file.md > output.html

Node API Usage

const rmj = require('render-markdown-js')
const html = rmj('#string of markdown')

Options

There are none. Copy, paste, tweak.

Enjoy!

Please enjoy!

comments powered by Disqus