# \#markdown

**URL:** https://discourse.gohugo.io/tag/markdown/111.md

[Latest](https://discourse.gohugo.io/latest.md) · [Categories](https://discourse.gohugo.io/categories.md) · [Tags](https://discourse.gohugo.io/tags.md)

---

## [Markdown linter for Hugo content — fast, no Node.js, link validation built in](https://discourse.gohugo.io/t/markdown-linter-for-hugo-content-fast-no-node-js-link-validation-built-in/57034)

<div class="topic-metadata">

**Author:** [@kazutomo.deguchi](https://discourse.gohugo.io/u/kazutomo.deguchi)\
**Replies:** 0\
**Last updated:** [April 21, 2026, 2:42pm UTC](https://discourse.gohugo.io/t/markdown-linter-for-hugo-content-fast-no-node-js-link-validation-built-in/57034 "2026-04-21T14:42:38Z")

</div>

I built a Markdown linter called gomarklint and wanted to share it here since Hugo is one of the main use cases I had in mind. The short version: single binary, no Node.js required, and it’s fast — 100,000+ lines in ~17…

---

## [What is the officially recommended syntax for relative links?](https://discourse.gohugo.io/t/what-is-the-officially-recommended-syntax-for-relative-links/56603)

<div class="topic-metadata">

**Author:** [@ZhenShuo2021](https://discourse.gohugo.io/u/ZhenShuo2021)\
**Replies:** 19\
**Last updated:** [January 23, 2026, 5:02pm UTC](https://discourse.gohugo.io/t/what-is-the-officially-recommended-syntax-for-relative-links/56603 "2026-01-23T17:02:09Z")

</div>

Hi, I’m trying to understand the correct way to write relative links in markdown. To investigate this, I created a custom render-link.html: {{- $u := urls.Parse .Destination -}} {{- with .PageInner.GetPage (strings.Tri…

---

## [Markdown issues](https://discourse.gohugo.io/t/markdown-issues/56575)

<div class="topic-metadata">

**Author:** [@Tom\_Durand](https://discourse.gohugo.io/u/Tom_Durand)\
**Replies:** 3\
**Last updated:** [January 15, 2026, 5:55am UTC](https://discourse.gohugo.io/t/markdown-issues/56575 "2026-01-15T05:55:22Z")

</div>

Hi, this is rather a markdown question (I suppose) and it might already have been asked, in such case, sorry. I have a list of pictures (with ) and I can’t apply markdown attributes to the individual figures. - !\[bonob…

---

## [Split markdown content in two .content \<sections\> (and: don't put them inside p tags)](https://discourse.gohugo.io/t/split-markdown-content-in-two-content-sections-and-dont-put-them-inside-p-tags/54148)

<div class="topic-metadata">

**Author:** [@woefi](https://discourse.gohugo.io/u/woefi)\
**Replies:** 3\
**Last updated:** [March 30, 2025, 8:43pm UTC](https://discourse.gohugo.io/t/split-markdown-content-in-two-content-sections-and-dont-put-them-inside-p-tags/54148 "2025-03-30T20:43:52Z")

</div>

Hi! I successfully used @jmooring 's answer (from 2021: Split markdown content in two files, but don’t render shortcodes as raw text ) to split the content of a single .md file into separate section-divs. //originally …

---

## [Hey everyone, I would like to know if it is possible to support an extended markdown format like obsidian comments](https://discourse.gohugo.io/t/hey-everyone-i-would-like-to-know-if-it-is-possible-to-support-an-extended-markdown-format-like-obsidian-comments/52321)

<div class="topic-metadata">

**Author:** [@Lruihao](https://discourse.gohugo.io/u/Lruihao)\
**Replies:** 5\
**Last updated:** [November 20, 2024, 9:35am UTC](https://discourse.gohugo.io/t/hey-everyone-i-would-like-to-know-if-it-is-possible-to-support-an-extended-markdown-format-like-obsidian-comments/52321 "2024-11-20T09:35:35Z")

</div>

I saw the 0.137.1 version of create an embedded comment shortcode in #13011, I would like to know if it is possible to support an extended markdown format like obsidian comments. This is an %%inline%% comment. %% This …

---

## [Enabling Goldmark extension ABBR from PHP Markdown Extra](https://discourse.gohugo.io/t/enabling-goldmark-extension-abbr-from-php-markdown-extra/51515)

<div class="topic-metadata">

**Author:** [@jsabater](https://discourse.gohugo.io/u/jsabater)\
**Replies:** 2\
**Last updated:** [September 11, 2024, 9:03am UTC](https://discourse.gohugo.io/t/enabling-goldmark-extension-abbr-from-php-markdown-extra/51515 "2024-09-11T09:03:26Z")

</div>

Hey everyone! I am trying to enable the abbreviations extension of the PHP Markdown Extra pack included in the Goldmark parser, but I have not been able to. I don’t know whether it’s a syntax problem, or whether it’s ju…

---

## [Markdown Headings not rendering on site](https://discourse.gohugo.io/t/markdown-headings-not-rendering-on-site/51153)

<div class="topic-metadata">

**Author:** [@m-pent](https://discourse.gohugo.io/u/m-pent)\
**Replies:** 2\
**Last updated:** [August 14, 2024, 4:23pm UTC](https://discourse.gohugo.io/t/markdown-headings-not-rendering-on-site/51153 "2024-08-14T16:23:22Z")

</div>

Hello, I’ve been trying a few different configuration changes, after reading the various Hugo documentation on Markdown and Markdown Configuration but I am still unsure of why when checked with a Markdown validator (or …

---

## [Is it possible to render uncited footnotes/references?](https://discourse.gohugo.io/t/is-it-possible-to-render-uncited-footnotes-references/50993)

<div class="topic-metadata">

**Author:** [@mason](https://discourse.gohugo.io/u/mason)\
**Replies:** 8\
**Last updated:** [August 5, 2024, 2:27am UTC](https://discourse.gohugo.io/t/is-it-possible-to-render-uncited-footnotes-references/50993 "2024-08-05T02:27:48Z")

</div>

I use footnotes extensively in my writing. However, sometimes I’d like to add additional sources that I don’t directly reference. For example: # Content something \[^a\] something else \[^c\] # Footnotes \[^a\]: one \[^b\]: …

---

## [Markdown image tags are being rendered verbatim](https://discourse.gohugo.io/t/markdown-image-tags-are-being-rendered-verbatim/50503)

<div class="topic-metadata">

**Author:** [@jacklund](https://discourse.gohugo.io/u/jacklund)\
**Replies:** 4\
**Last updated:** [July 1, 2024, 4:20am UTC](https://discourse.gohugo.io/t/markdown-image-tags-are-being-rendered-verbatim/50503 "2024-07-01T04:20:55Z")

</div>

Hi, I’m trying out Hugo, and trying to migrate my existing Jekyll website to it, but running into issues. The page in question has the following Markdown section: # Padlocks ## Master Lock #3 !\[Master Lock #3\](/asset…

---

## [Brackets inside a markdown link disable formatting](https://discourse.gohugo.io/t/brackets-inside-a-markdown-link-disable-formatting/50419)

<div class="topic-metadata">

**Author:** [@jzeneto](https://discourse.gohugo.io/u/jzeneto)\
**Replies:** 3\
**Last updated:** [June 27, 2024, 4:49am UTC](https://discourse.gohugo.io/t/brackets-inside-a-markdown-link-disable-formatting/50419 "2024-06-27T04:49:06Z")

</div>

Whenever I have a link like \[\*\[a thing\]\* and \*another\*\](example.com) it gets rendered as \*\[a thing\]\* and another by Hugo (note the two asterisks around brackets that don’t turn into italics). It seems the brackets dis…

---

## [Paste to Markdown](https://discourse.gohugo.io/t/paste-to-markdown/50141)

<div class="topic-metadata">

**Author:** [@idarek](https://discourse.gohugo.io/u/idarek)\
**Replies:** 0\
**Last updated:** [June 4, 2024, 5:40am UTC](https://discourse.gohugo.io/t/paste-to-markdown/50141 "2024-06-04T05:40:38Z")

</div>

Reading Mansoor Barri (4 Essential Markdown Tools • Mansoor Barri) post on his Hugo website I want to highlight to everybody one tool that may be very usefull. The tool is used to copy to clipboard any part of the websi…

---

## [From HTML to Markdown with MarkdownDown](https://discourse.gohugo.io/t/from-html-to-markdown-with-markdowndown/49473)

<div class="topic-metadata">

**Author:** [@idarek](https://discourse.gohugo.io/u/idarek)\
**Replies:** 1\
**Last updated:** [April 25, 2024, 9:05am UTC](https://discourse.gohugo.io/t/from-html-to-markdown-with-markdowndown/49473 "2024-04-25T09:05:05Z")

</div>

From time to time people asking how to move website, where git-source is lost, back to markdown. I want to refer you to website that I discovered recently that can do that from any website. Results may be mixed, but bett…
