The_Codex

The Language
of Your
Thoughts

Markdown is plain text with a handful of symbols. No software required to read it. No format lock-in. No menus to navigate. Just you and your ideas.

15
Syntax Rules
~10min
To Fluency
30+yrs
Battle-Tested
∞
Portability

Philosophy

Content_vs_Style

Write first.
Format never.

Word processors make you a typographer before you are a thinker. You pick fonts, adjust margins, fight with bullet indentation — before you have written a single real sentence.

Markdown inverts this. A # means heading. A **word** means bold. That is the entire visual vocabulary. Everything else is your content.

Portable_Forever

Open any
app. Ever.

A .docx from 2005 may not open in 2035. A .md file from 1994 opens in every text editor ever built.

Markdown is stored as plain text. You own it completely. Copy it, email it, version-control it, read it in a terminal. No subscription cancels your access to your own thinking.

In_Practice

Document StructureRaw → Rendered
Markdown_Source
# Project Status

## In Progress
- [x] Database schema
- [x] Auth flow
- [ ] API endpoints
- [ ] UI components

## Notes
Kick-off was **Monday**. Target: end of sprint.
Rendered

Project Status

In Progress

✅ Database schema

✅ Auth flow

⬜ API endpoints

⬜ UI components

Notes

Kick-off was Monday. Target: end of sprint.

Structured DataRaw → Rendered
Markdown_Source
| Tool      | Format    | Portable |
|-----------|-----------|----------|
| Notion    | Proprietary | ✗      |
| Word      | .docx     | Partial  |
| mdcrypt   | Markdown  | ✓        |

> Your notes should outlive the app you use to write them.
Rendered
ToolFormatPortable
NotionProprietary✗
Word.docxPartial
mdcryptMarkdown✓
Your notes should outlive the app you use to write them.
Everyday WritingRaw → Rendered
Markdown_Source
## Book Notes — Thinking Fast and Slow

**Core thesis:** Two cognitive systems govern decisions.

- *System 1* — fast, instinctive, emotional
- *System 2* — slow, deliberate, logical

```
Anchoring bias: first number seen
skews all subsequent estimates.
```
Rendered

Book Notes — Thinking Fast and Slow

Core thesis: Two cognitive systems govern decisions.

  • System 1 — fast, instinctive, emotional
  • System 2 — slow, deliberate, logical
Anchoring bias: first number seen
skews all subsequent estimates.

For_Everyone

Technical_Users

Already in your workflow

  • —GitHub README and wikis are Markdown
  • —Docstrings and JSDoc render as Markdown
  • —Every major AI model outputs Markdown natively
  • —Git diffs are clean — no binary format noise
  • —Terminal-readable without any rendering step
Non-Technical_Users

Simpler than you think

  • —15 rules covers 95% of everyday writing
  • —Looks readable even without rendering
  • —Works in any app — email, notes, docs
  • —No software to install, no account needed
  • —You already know bold and bullet points
“The best format is one you can read without opening an app.”

— On plain text permanence

Syntax_Reference

Headings
# H1  ## H2  ### H3

# prefix = heading level

Bold & Italic
**bold**  *italic*
***bold italic***
Bullet Lists
- First item
- Second item
  - Nested item

Indent 2 spaces to nest

Numbered Lists
1. First
2. Second
3. Third
Task Lists
- [x] Done
- [ ] Todo

GFM extension, supported in mdcrypt

Links
[Link text](https://url.com)
[[Wiki Link]]

[[double bracket]] for internal notes

Inline Code
Use `code` inline.
Code Blocks
```python
def hello():
    return 'world'
```

Specify language for syntax highlighting

Blockquote
> This is a quote.
> It can span lines.
Tables
| Col A | Col B |
|-------|-------|
| val   | val   |
Horizontal Rule
---

Three or more dashes

YAML Frontmatter
---
title: My Note
tags: [idea]
---

Must be at the very top of the file

Why_It_Matters

AI-Native

Every major language model was trained on Markdown. Your notes are instantly machine-readable without any conversion step.

Version Control

Plain text diffs cleanly. Track every change with Git. See exactly what was added, removed, or moved — line by line.

Works Everywhere

GitHub, VS Code, Obsidian, Typora, terminal cat — every tool that touches text understands Markdown.

Offline Forever

No internet connection required to write or read. Your vault is a directory of text files. Always accessible.

Zero Learning Curve

You already know bold, bullets, and headings. The full syntax fits on one page. Fluency in 10 minutes.

Future-Proof

Text files written in 1994 open perfectly today. Your notes will still be readable in 2054, regardless of what apps exist.

Your notes.
Your format.
Forever.

mdcrypt stores everything as Markdown. No proprietary format. No lock-in. Switch tools anytime — your notes travel with you.

Open Your Crypt