Skip to content

Instantly share code, notes, and snippets.

@naugtur
Last active September 30, 2025 09:05
Show Gist options
  • Select an option

  • Save naugtur/bcd4dab7d23e44bd869aa9c4e337065d to your computer and use it in GitHub Desktop.

Select an option

Save naugtur/bcd4dab7d23e44bd869aa9c4e337065d to your computer and use it in GitHub Desktop.
rare markdown syntax

markdown syntax I've never seen documented

Credit where credit is due: I saw the table align one first in Gemini output. Asked it if it knew more niche markdown tricks and learned all these.

table column align

Left-Aligned ⬅️ Center-Aligned ↔️ Right-Aligned ➡️
apple This is text 100
orange in the middle 10
banana of the column 1

comment

a bit flaky support

some content with

a comment inbetween. gotta have the newlines around it. Some renderers don't require the # part

//: good enough comment for some renderers

highlight

rarely supported

  • To draw attention to something: ==This is important!==
  • To get a more widely supported effect, use html This is important!

footnote

not all renderers

Here is some text with a point that needs a reference.1 The numbering is handled automatically. You can add another one right after.2

Other rare syntax that's sometimes hard to remember

collapsible

👉 Click here to see the details!

Here is the hidden content. It can be anything you want:

  • A list
  • A code block
  • Images, etc.

Footnotes

  1. This is the first footnote.

  2. This is the second one, identified by a name.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment