Markdown Guide

Markdown Guide

This post demonstrates the standard Markdown formatting features supported by Darklane.

The post itself uses many of Darklane’s Hugo shortcodes internally.

Headers

Darklane supports all six header levels with clean typography:

H1 Header

H2 Header

H3 Header

H4 Header

H5 Header
H6 Header
info
You can also add color to headers using CSS classes

Colored Header

Another Color

colors:

  • .text-primary
  • .text-secondary
  • .text-accent-1
  • .text-accent-2
  • .text-accent-3
  • .text-error
  • .text-bright
  • .text-dim

Text Formatting

Bold text for emphasis, italic text for subtle emphasis, and inline code for technical terms.

You can combine them: bold and italic or bold with code.

Lists

Unordered lists:

  • First item
  • Second item
    • Nested item
    • Another nested item
  • Third item

Ordered lists:

  1. First step
  2. Second step
    1. Sub-step A
    2. Sub-step B
  3. Third step

Code Blocks

Syntax highlighted code blocks with language detection:

def fibonacci(n):
    if n <= 1:
        return n
    return fibonacci(n-1) + fibonacci(n-2)

print(fibonacci(10))
function greet(name) {
  console.log(`Hello, ${name}!`);
}

greet("World");

You can also highlight specific lines:

def calculate_sum(a, b):
    result = a + b  # This line is highlighted
    print("Calculating...")
    return result   # This line is highlighted too

Tables

This table shows the default stying; it doesn’t use a shortcode.

LanguageTypeFirst Release
PythonInterpreted1991
JavaScriptInterpreted1995
GoCompiled2009
RustCompiled2010
note
Tables don’t need to line-up in the markdown to render correctly, but are much easier to interpret when just reading as text.

The next example uses the table shortcode.

FeatureSupportNotes
Syntax HighlightingMultiple languages
LaTeX MathInline and display
ResponsiveMobile-friendly
Dark ModeBuilt-in
info
Without a color argument, the border between the labels data will be --color-primary.

Blockquotes

This is a blockquote. It’s useful for highlighting important information or quoting other sources. Blockquotes can span multiple paragraphs and include other formatting.

Visit the Hugo documentation for more information.

Images work too (when you add them to your post bundle):

![Alt text](image.jpg)

LaTeX Math

Inline math: $E = mc^2$

Display math:

$$ \int_{-\infty}^{\infty} e^{-x^2} dx = \sqrt{\pi} $$

That’s the basics of Markdown in Darklane!