Hugo

This site is written in Markdown and generated with the static site generator (SSG) Hugo. Markdown is a simple plain text document format that can be easily and quickly processed to generate html, pdf, .docx, and a number of other file formats. I use it for just about all my writing - for documents and articles (I avoid Microsoft Word at all costs!), note taking, and for writing web pages. Hugo quickly generates an efficient website. Since the website is made up only of static webpages and a little JavaScript, it renders fast.

I started with the Mainroad theme, and gradually added customizations and extensions. (I spend way too much time fretting about formatting and not nearly enough time actually writing content - And the results are pretty mediocre in any case!)

This is a test page that uses it’s own page template to display GoHugo template functions and variables. The page really just exists to trigger the use of the template.

The article discusses the details of how Goldmark Markdown and Hugo handles images, along with how to add attributes such a positioning and sizing when using images in a Hugo Markdown file.

Introduction

This article focuses on markdown as supported by Hugo and Pandoc. Here are a few good Markdown references and tutorials:

Markdown Guide
Wikipedia Markdown entry
CommonMark - the markdown “standard”

Hugo’s Markdown

Hugo uses the GoldMark as it’s default Markdown processor. Goldmark supports the CommonMark standard, along with:

Tables, Strikethrough, Autolinks, TaskLists from GitHub-Flavored Markdown
Definition Lists and Footnotes from PHP Markdown Extra
Special typographic characters from SmartyPants
Embedded HTML may be enabled in the Hugo Site Configuration
Attribute lists on headings and block elements to add styling. See Hugo Site Configuration and Easier writing

Hugo Goldmark also supports:

MathJax support, including AsciiMath, with the appropriate support in the theme layouts
Syntax highlighting in fenced code blocks using Chroma syntax highlighter. See Hugo Syntax Highlighting for details.
Emoji Support. Set enableEmoji to true in the main site configuration. For a list of emoji see Emoji Cheat Sheet

Pandoc’s Markdown

See Pandoc’s Markdown for details.

Colophon - How this Site is Made

Test Page to play with Hugo template functions

Hugo Markdown Image Handling

Hugo's Markdown Extensions

Introduction

Hugo’s Markdown

Pandoc’s Markdown