Rendering Markdown

Markdown is a common text-based file format that is often used for writing documentation, blogs and more. In this example we are going convert markdown content to HTML and send it to the browser.

First, let’s install the @deno/gfm package that can transform markdown to html.

Run deno install jsr:@deno/gfm
Create a markdown file like content/example.md:

content/example.md

## some heading

and some interesting text here

> oh look a blockquote

Add a route that renders that file

routes/markdown.tsx

import { define } from "@/utils.ts";
import { CSS, render as renderMarkdown } from "@deno/gfm";

export default define.page(async () => {
  const content = await Deno.readTextFile("./content/example.md");
  const html = renderMarkdown(content);

  return (
    <div>
      <h1>Here comes a markdown post:</h1>
      {/* deno-lint-ignore react-no-danger */}
      <style dangerouslySetInnerHTML={{ __html: CSS }} />
      {/* deno-lint-ignore react-no-danger */}
      <div dangerouslySetInnerHTML={{ __html: html }} />
    </div>
  );
});

For a more elaborate markdown system with Fresh, take a look at the source code for this documentation website.

Other libraries

There are several other popular libraries besides @deno/gfm that can be used to render markdown. The most common ones are:

Rendering Markdown

Other libraries#

Other libraries