Getting Started with Markdown in WordPress

Welcome to your Git-versioned, Markdown-first WordPress site with full Digital Garden features!

Architecture Flow

Here is how local Markdown files flow into your live WordPress site:

graph TD
    A[Obsidian / Local Markdown] -->|git commit & push| B[GitHub Repo]
    A -->|uv run scripts/sync.py| C[WP-CLI Container]
    C -->|Upsert Content & Graph| D[WordPress MariaDB]
    D -->|Serve Rendered Notes| E[Caddy Reverse Proxy]
    E -->|HTTPS| F[Readers / Browser]

Why This Setup?

This workflow gives you the best of both worlds:
1. Developer Experience: Write posts in your favorite local editor using standard Markdown.
2. Git Version Control: Every edit, draft, and revision is tracked in GitHub.
3. Interactive Graph & Previews: Seamless navigation across connected thoughts.

Math Equation Example

KaTeX dynamically renders inline math like $E = mc^2$ and block equations:

$$\sum_{k=1}^{n} k = \frac{n(n+1)}{2}$$

Obsidian Callout Box Examples

Code Example

Here is a quick Python example demonstrating how clean code blocks render:

def publish_post(title: str, content: str) -> bool:
    print(f"Publishing post: {title}")
    return True

Backlinks and Interconnections

This note connects back to the Home Page and the About Site page.