---
layout: markmark
permalink: /markmark/
---

MarkMark is a free ([as in freedom](https://en.wikipedia.org/wiki/Free_as_in_Freedom)) bookmark format designed to be machine-readable and easy to use.

The goal of MarkMark is to standardize "link sharing" pages to build connections between small websites on the Internet.

You can view the [full standard here](/markmark/standard).

MarkMark was inspired by the post [_The Small Website Discoverability Crisis_](https://www.marginalia.nu/log/19-website-discoverability-crisis/) on the Marginalia blog.

# Example

```markdown
[//]: #(markmark-syntax: v1)
[//]: #(markmark-author-name: Garrett Mills)
[//]: #(markmark-author-email: shout@garrettmills.dev)
[//]: #(markmark-author-href: https://garrettmills.dev/)

# My Sites

Here are links to various sites created by yours truly.

- Garrett Mills
    - https://garrettmills.dev/

- My Code
    - https://code.garrettmills.dev/garrettmills

- Post: Mitigating CVE-2024-2961 (2024-04-22)  #blog
    - https://garrettmills.dev/blog/2024/04/22/Mitigating-the-iconv-Vulnerability-for-PHP-CVE-2024-2961
```

# Resources

- [Spec: Standard MarkMark (v1.0)](/markmark/standard)
- MarkMark Icons ([Light](/assets/markmark-light.svg), [Dark](https://garrettmills.dev/assets/markmark-dark.svg))
- [`mark-mark`: a TypeScript MarkMark parser/renderer collection](https://code.garrettmills.dev/garrettmills/www/src/branch/master/src/markmark)
  - Heads up! Unlike the MarkMark Spec, the `mark-mark` library is licensed CC BY-NC-SA 4.0. [Learn more.](/technical/#source-code-and-licensing)
