Markdown editor — Jacob Corcoran

Untitled.md

Point this at your blog’s src folder to list every post, open one with a click and save straight back to disk.

Text

*italic*: italic
**bold**: bold
~~struck~~: strikethrough
`code`: inline code

Structure

## Heading: start at ## — the title is already the h1
### Smaller: and so on to ######
> quoted: blockquote
---: horizontal rule
blank line: new paragraph

Lists

- item: bullet
1. item: numbered
two spaces in: nests under the item above

Links & images

[text](https://…): link
<https://…>: a bare link — the angle brackets are required
![alt](/images/x.jpg): image; start the path with /

Code & breaks

```js … ```: fenced block, language optional
two trailing spaces: forces a line break
one newline: is only a space — not a break

Not on your blog

Valid markdown elsewhere. Here it publishes as the literal characters, or as something you did not intend.

- [ ] task: no task-list plugin
[^1] footnote: no footnote plugin
https://… on its own: not linked — use <…> or [text](url)
four-space indent: not a code block — use a ``` fence
{{ … }} or {% … %}: Liquid runs first and eats it, fences included — wrap in {% raw %}…{% endraw %}
# Heading: a second h1 — the title already is one
[[wiki link]]: not markdown — use [text](/posts/slug/)
![[embed]]: not markdown — use ![alt](/images/…)
> [!note]: no callouts — a blockquote with [!note] in it
==highlight==: publishes the == marks
%%comment%%: publishes visibly — there are no md comments
$$maths$$: no maths; publishes the $ signs
```mermaid: no diagrams; publishes the source

Links & files

/posts/slug/: another post — root-relative, trailing slash, never .md
/about/: other pages
/images/slug/x.jpg: images live in src/images/<slug>/
jpg png gif svg webp avif: only these are copied — anything else 404s
filename: lowercase, hyphens, no spaces
<img width height>: raw HTML avoids the page jumping as it loads

Keys

Ctrl B / I / K: bold, italic, link
Ctrl S: save to the file on disk
Enter: continues a list; again on an empty item ends it
paste a URL: over selected text makes a link

Title Date

Draft

Layout Image Image alt Excerpt Description

Homepage card

Search & social

Preview