Notes
All notes

Markdown demo: every element

A single page that exercises every construct the renderer supports, so a theme can be checked end to end. If something here looks wrong, it is a theme bug.

Headings

Third-level heading

Fourth-level heading

Fifth-level heading
Sixth-level heading

Inline styles

Bold text, italic text, bold italic, strikethrough, and inline code. A link to Go and a bare autolink https://example.com. Escaped punctuation stays literal: *not italic* and _not underlined_.

Lists

  1. First ordered item
  2. Second ordered item
    1. A nested ordered item
    2. Another nested item
  3. Third ordered item

Definition list

Kite
A minimal static site generator written in Go.
Theme
Two HTML files — home.html and layout.html — in standard Go templates.

Blockquote

A normal blockquote. It can span several lines and contain inline markup and code, and it wraps as one continuous thought.

Question and solution blocks

QQuestionWhat is a static site generator?
ASolution

A program that turns source files (usually Markdown) plus templates into plain HTML that can be served by any web server. There is no runtime, no database and no application server — just files.

QQuestionWhy does the solution block start collapsed?
ASolution

So a page of revision questions can be used as a self-test: read the question, answer it out loud, then reveal the answer.

It is a native <details> element, so it also works without JavaScript.

Code

Inline code sits in the flow. Fenced blocks are syntax highlighted:

def two_sum(nums, target):
    seen = {}
    for i, x in enumerate(nums):
        if target - x in seen:
            return [seen[target - x], i]
        seen[x] = i
    return []
func twoSum(nums []int, target int) []int {
	seen := make(map[int]int)
	for i, x := range nums {
		if j, ok := seen[target-x]; ok {
			return []int{j, i}
		}
		seen[x] = i
	}
	return nil
}
go install github.com/HimanshuSardana/kite@latest
kite new my-post.md
kite build && kite serve
A plain text block, with no highlighting at all.
It keeps its   spacing   exactly.

Table

Command What it does Cost
kite init Scaffold a new site Interactive
kite new Create a post with frontmatter Instant
kite build Render the site into output/ Milliseconds
kite serve Preview with live reload Dev only
kite check Find broken internal links Instant

Math

Inline math like \(e^{i\pi} + 1 = 0\) and \(\frac{1}{n}\sum_{k=1}^{n} k\) flows with the text. Display math gets its own centred line:

\[ \int_{-\infty}^{\infty} e^{-x^2}\,dx = \sqrt{\pi} \]

Aligned derivations line up on the & markers:

\[ \begin{aligned} (a+b)^2 &= (a+b)(a+b) \\ &= a^2 + 2ab + b^2 \end{aligned} \]

Diagram

Arbitrary TikZ renders to inline SVG in the browser:

\begin{tikzpicture}[
  n/.style={draw,thick,circle,minimum size=0.8cm,font=\small},
  a/.style={->,thick}
]
  \node[n] (a) at (0,0) {A};
  \node[n] (b) at (2.4,0) {B};
  \node[n] (c) at (1.2,-1.8) {C};
  \draw[a] (a) -- (b);
  \draw[a] (b) -- (c);
  \draw[a] (c) -- (a);
\end{tikzpicture}

Images

A local image and an external one:

Local SVG logo

External image

HTML passthrough

Raw HTML is passed through untouched, which is handy for small layout tweaks:

This line is centred with raw HTML.

Horizontal rule

Above and below the rule.


That is the whole set. Everything above is plain Markdown in content/markdown-demo.md.