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
- First unordered item
- Second unordered item
- A nested item
- A deeper item
- A nested item
- Third unordered item
- First ordered item
- Second ordered item
- A nested ordered item
- Another nested item
- Third ordered item
Definition list
- Kite
- A minimal static site generator written in Go.
- Theme
- Two HTML files —
home.htmlandlayout.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
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.
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:
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.