Hugo embed HTML in Markdown

After the longest time I switched to the default Hugo markdown rendered, Goldmark, from Blackfriday. I delayed the switch for the longest time but in version 0.100 they removed the old markdown rendered that was deprecated.

Unfortunately this meant all my embedded HTML in markdown stopped working.

I solved this by enabling this option in my config.yaml:

markup:
  goldmark:
    renderer:
      unsafe: true

or, in config.toml:

[markup.goldmark.renderer]
  unsafe = true

Written on Jul 8, 2022

→ Get my Go Handbook

I wrote 21 books to help you become a better developer:

HTML Handbook
Next.js Pages Router Handbook
Alpine.js Handbook
HTMX Handbook
TypeScript Handbook
React Handbook
SQL Handbook
Git Cheat Sheet
Laravel Handbook
Express Handbook
Swift Handbook
Go Handbook
PHP Handbook
Python Handbook
Linux Commands Handbook
C Handbook
JavaScript Handbook
Svelte Handbook
CSS Handbook
Node.js Handbook
Vue Handbook

...download them all now!

Also, JOIN MY CODING BOOTCAMP, an amazing cohort course that will be a huge step up in your coding career - covering React, Next.js - next edition February 2025