Skip to content

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
→ Get my Go Handbook

I wrote 17 books to help you become a better developer, download them all at $0 cost by joining my newsletter

  • C Handbook
  • Command Line Handbook
  • CSS Handbook
  • Express Handbook
  • Git Cheat Sheet
  • Go Handbook
  • HTML Handbook
  • JS Handbook
  • Laravel Handbook
  • Next.js Handbook
  • Node.js Handbook
  • PHP Handbook
  • Python Handbook
  • React Handbook
  • SQL Handbook
  • Svelte Handbook
  • Swift Handbook

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

Bootcamp 2025

Join the waiting list