Login
Authoring & Syntax ReferenceMadaatih Pure Markdown

Writing & Markdown Guide

"In a world of noisy toolbars and complex formatting menus, pure words remain the sharpest tool for human thought."

Madaatih is engineered around a purely markdown-first philosophy. There are no distracting button toolbars or clunky GUI builders—structure your writing, render mathematical equations, and generate interactive flowcharts directly from plain text.

Start Writing in EditorTry Live Playground
$ / $$ KaTeX Math```mermaid Pure Flowcharts| Tables | Markdown PipesF Key Focus Mode# Headings Chapter Steps
01

Typography & Basic Styling

Headings, emphasis, blockquotes, and code marks formatted with clean typographic rhythm.

MarkdownHeadings & Chapter Navigation
Syntax
# Heading 1 (Scribble Title)
## Heading 2 (Major Section)
### Heading 3 (Sub-chapter)
Rendered Result

Heading 1 (Scribble Title)

Heading 2 (Major Section)

Heading 3 (Sub-chapter)

Scrollytelling Integration: Headings automatically generate the right-side chapter steps and top reading progress bar in the reader view.
MarkdownText Emphasis & Inline Code
Syntax
**Bold weight text**
*Subtle italic tone*
~~Strikethrough text~~
`inline code fragment`
Rendered Result

Bold weight text gives key statements authority.

Subtle italic tone emphasizes quiet thoughts.

Strikethrough text indicates discarded revisions.

Use inline code fragment for variables or keys.

MarkdownEditorial Blockquotes
Syntax
> In a world of infinite distraction, the greatest luxury 
> is a blank page and uninterrupted time to think.
Rendered Result
In a world of infinite distraction, the greatest luxury is a blank page and uninterrupted time to think.
02

Lists & Task Checkboxes

Organize sequential reasoning, bullet thoughts, and interactive task checklists.

MarkdownOrdered & Unordered Lists
Syntax
- Idea formulation
- Draft stream-of-consciousness
  - Freeform drafting
  - Structural polish

1. Open editor
2. Compose scribble
3. Share with world
Rendered Result
  • Idea formulation
  • Draft stream-of-consciousness
    • Freeform drafting
    • Structural polish
  1. Open editor
  2. Compose scribble
  3. Share with world
MarkdownTask Checklists
Syntax
- [x] Jot raw shower thoughts
- [x] Derive mathematical proof
- [ ] Add explanatory flowchart
- [ ] Publish privately for review
Rendered Result
✓ Jot raw shower thoughts
✓ Derive mathematical proof
Add explanatory flowchart
Publish privately for review
03

KaTeX Mathematical Typesetting

High-performance LaTeX typesetting for formulas, calculus, physics, and statistics.

KaTeX InlineInline Equations ($...$)
Syntax
Mass-energy equivalence is $E = mc^2$.

Roots given by $x = \frac{-b \pm \sqrt{b^2 - 4ac}}{2a}$.
Rendered Result

Mass-energy equivalence is E=mc2E = mc^2.

Roots given by x=−b±b2−4ac2ax = \frac{-b \pm \sqrt{b^2 - 4ac}}{2a}.

Wrap expressions in single dollar signs $formula$ without inner leading/trailing spaces.
KaTeX EscapeCurrency & Literal Dollar Signs
Syntax
Our coffee budget is \$15 weekly.
Never triggers unintended math formatting!
Rendered Result

Our coffee budget is $15 weekly.

Never triggers unintended math formatting!

To output a literal dollar symbol without entering math mode, prefix it with a backslash: \$.
KaTeX DisplayDisplay & Multi-line Equations ($$...$$)
Syntax
$$
\int_{-\infty}^{\infty} e^{-x^2} dx = \sqrt{\pi}
$$

$$
\nabla \times \mathbf{E} = -\frac{\partial \mathbf{B}}{\partial t}
$$
Rendered Result
∫−∞∞e−x2dx=π\int_{-\infty}^{\infty} e^{-x^2} dx = \sqrt{\pi}
∇×E=−∂B∂t\nabla \times \mathbf{E} = -\frac{\partial \mathbf{B}}{\partial t}
04

Mermaid.js Flowcharts & Diagrams

Purely markdown-driven diagramming. No cumbersome visual tools—just write fenced code.

Pure Markdown Philosophy

In Madaatih, you don't need buttons, plugins, or third-party chart builders to make diagrams. Simply type a fenced code block with ```mermaid or ```flowchart. The reader automatically converts it into a high-resolution vector diagram complete with an interactive full-screen viewer and one-click syntax copy.

MermaidFlowchart Syntax & Interactive Viewer
Syntax in Editor
```mermaid
graph TD
    A[Raw Shower Thought] --> B{Structure Needed?}
    B -->|Yes| C[Add Flowchart Diagram]
    B -->|No| D[Pure Prose Scribble]
    C --> E[Immersive Scrollytelling]
    D --> E
```
Reader Experience
Flow ChartMermaid
Interactive vector diagram
Click to expand
Rendering vector flowchart...

Flow Directions

TD / TB Top to bottom
LR Left to right
BT Bottom to top
RL Right to left

Node Geometries

[Label] Standard rectangle
(Label) Rounded rectangle
([Label]) Stadium / pill
{Label} Decision rhombus

Connectors & Labels

--> Solid directed arrow
-->|Text| Arrow with label
--- Open connection link
==> Thick heavy arrow
05

Structured Data & Tables

Format comparisons, matrices, and tabular metrics using standard markdown pipes.

MarkdownMarkdown Table Syntax
Syntax
| Concept | Syntax | Native Rendering |
| :--- | :---: | ---: |
| Math | `$E=mc^2$` | KaTeX Engine |
| Flowchart | ```` ```mermaid ```` | Mermaid.js |
| Privacy | Draft / Unlisted | Supabase Row-Level |
Rendered Result
ConceptSyntaxNative Rendering
Math$E=mc^2$KaTeX Engine
Flowchart```mermaidMermaid.js
PrivacyDraft / UnlistedSupabase Row-Level
Editor Auto-Trigger: In the Madaatih editor, simply type | Col 1 | Col 2 | and press Space or Enter to automatically instantiate an interactive table.
07

Reader Experience & Shortcuts

Features built for your audience when consuming long-form scribbles.

F

Focus Mode

Press F or click the floating eye button. Headers, footers, and sidebars fade away, spotlighting the active reading paragraph.

Chapter Steps

Subtle right-side indicator dashes allow effortless one-click navigation across all major sections of your scribble.

Reading Pace

A top progress bar tracks reading velocity alongside an accurate reading time estimation derived from raw word counts.

08

Interactive Markdown Playground

Test your markdown, LaTeX equations, and Mermaid diagrams right here in real time.

Load Example:
Markdown InputType KaTeX ($...$), Mermaid, or Markdown
Live Rendering

The Art of Thinking

Writing is not the communication of something already discovered; it is the very act of discovery.

“Words are our most inexhaustible source of magic.”

  • Observe carefully
  • Scribble thoughts
  • Refine intuition