A Challenging Markdown Test Page

Welcome to the Omni-Syntax Specimen file. This document is designed to test the capabilities of a Markdown parser and a static site generator like Hugo. It contains a mix of standard and extended syntax, often in tricky combinations.

The summary of this page ends here.

Section 1: Fundamental Elements

This section covers the basics. We have bold text, italic text, and a combination of both. You can also use strikethrough.

Paragraphs are separated by a blank line. If you need a hard line break, you can use two trailing spaces.

Here is a link to the official Hugo documentation. And here is a link with a title attribute: Markdown Guide.

Section 2: Lists and Nesting (The Tricky Part)

Proper indentation is key here.

1. First ordered list item.
2. Second ordered list item, which contains a nested list:
   • Unordered sub-item 1.
   • Unordered sub-item 2, which in turn has more nesting:
     1. Can you believe this? Level three!
     2. It just keeps going.
3. Third ordered list item. It’s important to test that the numbering continues correctly.

Now for the real challenge. Let’s put complex blocks inside a list.

• A list item with a blockquote:

  This blockquote is indented within the list. Rendering this correctly requires the parser to handle context changes gracefully.

• A list item with a fenced code block:

  // This code is inside a list item!
  function greet(name) {
    console.log(`Hello, ${name}!`);
  }
  greet("World");
  

• A task list:

  • Complete challenge #1: Basic Syntax.
  • Complete challenge #2: Nesting.
  • Add more challenges.

Section 3: Code, Quotes, and Images

Inline code is simple: const a = 1;. But a full code block with syntax highlighting is more interesting.

# A simple Python script
def fibonacci(n):
    a, b = 0, 1
    while a < n:
        print(a, end=' ')
        a, b = b, a+b
    print()

fibonacci(100)

Blockquotes can also be nested:

Level 1: The beginning of a thought.

Level 2: A deeper layer of the same thought.

Level 3: “We need to go deeper.”

And here’s an image using standard Markdown syntax, with a link:

Section 4: Extended Syntax & HTML

Tables with Mixed Content

This tests alignment and inline markdown rendering within cells.

Footnotes & Definitions

Here is a simple footnote¹. And here is a more complex one with more text².

Definition List : A list where each item has a term and a definition. This is an extended Markdown feature.

Another Term : Another definition.

Raw HTML Definition List

This is rendered using raw HTML tags, which should also be supported.

Raw HTML Embedding

Sometimes you need to escape out of Markdown. The <details> element is a great test.

Section 5: Hugo-Specific Shortcodes

This section uses features unique to Hugo.

Figure Shortcode

This is the recommended way to handle images in Hugo, as it uses the <figure> element.

YouTube Embed

Embedding videos should be easy.

Highlight Shortcode

An alternative to fenced code blocks that guarantees Hugo’s Chroma highlighter is used.

 baseURL:
'https://example.org/' languageCode: 'en-us' title: 'My New Hugo Site' theme:
'ananke' 

This is the end of the specimen file. If this page rendered perfectly, your setup is robust!