this is my go to documentation for editing posts on this hugo site. it still uses markdown, but with some touch of style here and there.
Article frontmatter: Use front matter to add metadata to your content.
https://gohugo.io/content-management/front-matter/
--- author: ["Hugo Authors", "PaperMod Contributors", "Aditya Telange"] title: "Comprehensive Frontmatter Example" date: "2019-03-11" description: "A comprehensive guide showcasing Markdown, shortcodes, syntax, and formatting for HTML elements." summary: "Sample article demonstrating various frontmatter fields and their usage." tags: ["markdown", "shortcodes", "privacy", "syntax", "code", "gist", "css", "html", "themes", "emoji"] categories: ["themes", "syntax"] series: ["Themes Guide"] FAtags: ["markdown", "css", "html", "themes"] FAcategories: ["themes", "syntax"] FAseries: ["Themes Guide"] aliases: ["migrate-from-jekyl"] cover: image: images/msg.png caption: "Generated using [OG Image Playground by Vercel](https://og-playground.vercel.app/)" social: fediverse_creator: "@[email protected]" math: true weight: 2 ShowToc: true TocOpen: true ShowBreadCrumbs: false --- Inline Code This is Inline Code
Only pre This is pre text Code block with backticks <!DOCTYPE html> <html lang="en"> <head> <meta charset="utf-8" /> <title>Example HTML5 Document</title> <meta name="description" content="Sample article showcasing basic Markdown syntax and formatting for HTML elements." /> </head> <body> <p>Test</p> </body> </html> Code block with backticks and language specified <!DOCTYPE html> <html lang="en"> <head> <meta charset="utf-8" /> <title>Example HTML5 Document</title> <meta name="description" content="Sample article showcasing basic Markdown syntax and formatting for HTML elements." /> </head> <body> <p>Test</p> </body> </html> Code block with backticks and language specified with line numbers 1 2 3 4 5 6 7 8 9 10 11 12 13 14 <!DOCTYPE html> <html lang="en"> <head> <meta charset="utf-8" /> <title>Example HTML5 Document</title> <meta name="description" content="Sample article showcasing basic Markdown syntax and formatting for HTML elements." /> </head> <body> <p>Test</p> </body> </html> Code block with line numbers and highlighted lines PaperMod supports linenos=true or linenos=table 1 2 3 4 5 6 7 8 9 10 11 12 13 14 <!DOCTYPE html> <html lang="en"> <head> <meta charset="utf-8" /> <title>Example HTML5 Document</title> <meta name="description" content="Sample article showcasing basic Markdown syntax and formatting for HTML elements." /> </head> <body> <p>Test</p> </body> </html> With linenos=inline line might not get highlighted properly. This issue is fixed with 045c084 1<!DOCTYPE html> 2<html lang="en"> 3 <head> 4 <meta charset="utf-8" /> 5 <title>Example HTML5 Document</title> 6 <meta 7 name="description" 8 content="Sample article showcasing basic Markdown syntax and formatting for HTML elements." 9 /> 10 </head> 11 <body> 12 <p>Test</p> 13 </body> 14</html> Code block indented with four spaces <!doctype html> <html lang="en"> <head> <meta charset="utf-8"> <title>Example HTML5 Document</title> </head> <body> <p>Test</p> </body> </html> Code block with Hugo’s internal highlight shortcode <!doctype html> <html lang="en"> <head> <meta charset="utf-8"> <title>Example HTML5 Document</title> </head> <body> <p>Test</p> </body> </html> Github Gist https://gohugo.io/shortcodes/gist/
To display a specific file within the gist:
Emoji Emoji can be enabled in a Hugo project in a number of ways.
...