Help

Markdown

Origin & History

John Gruber created Markdown in 2004 with significant input from Aaron Swartz. The goal was a plain-text format that is readable as-is and converts cleanly to HTML.

CommonMark (2014) standardized the spec, resolving ambiguities in Gruber's original description. GitHub Flavored Markdown (GFM) extended CommonMark with tables, task lists, and strikethrough. Marky uses GFM rendering via Goldmark.

Syntax Reference

Markdown

# Heading 1
## Heading 2
### Heading 3

Rendered

Heading 1

Heading 2

Heading 3

Markdown

**bold** and *italic*
~~strikethrough~~
`inline code`

Rendered

bold and italic
~~strikethrough~~
inline code

Markdown

[link text](https://marky.md)

Rendered

link text

Markdown

- Item one
- Item two

1. First
2. Second

Rendered

Item one
Item two

First
Second

Markdown

> This is a blockquote
> with multiple lines

Rendered

This is a blockquote with multiple lines

Markdown

```
code block
```

Rendered

code block

Markdown

| Name | Value |
|------|-------|
| A    | 1     |

Rendered

Name	Value
A	1

Markdown

- [x] Done
- [ ] Todo

Rendered

Done
Todo

IPFS

What is IPFS?

IPFS (InterPlanetary File System) uses content addressing instead of location addressing. Rather than asking "where is this file?" you ask "who has this content?" Every piece of content gets a unique CID (Content Identifier) derived from its hash. If the content changes, the CID changes.

Marky uses IPFS to pin your markdown documents. When you save, your markdown is encrypted and the encrypted bytes are pinned; you get a permanent, content-addressed link that renders here on marky.md. Because each save is encrypted under a key of its own, saving the same document twice produces two different links — the CID is still derived from what was pinned, and what was pinned is never the same twice.

Origin & History

Juan Benet created IPFS at Protocol Labs and launched it in 2015. The project draws on ideas from Git, BitTorrent, and distributed hash tables to build a peer-to-peer hypermedia protocol. Filecoin, a blockchain-based storage network, provides economic incentives for long-term data persistence on IPFS.