diff --git a/content/blog/about-this-blog.md b/content/blog/about-this-blog.md index f4ad491..aca45d7 100644 --- a/content/blog/about-this-blog.md +++ b/content/blog/about-this-blog.md @@ -1,7 +1,7 @@ --- title: "About This Markdown Framework" description: "How this open source framework works with Convex for real-time sync and Netlify for deployment." -date: "2025-01-16" +date: "2025-12-14" slug: "about-this-blog" published: true tags: ["convex", "netlify", "open-source", "markdown", "ai", "llm"] diff --git a/content/blog/how-to-publish.md b/content/blog/how-to-publish.md index c2447b7..af62d10 100644 --- a/content/blog/how-to-publish.md +++ b/content/blog/how-to-publish.md @@ -1,7 +1,7 @@ --- title: "How to Publish a Blog Post" description: "A quick guide to writing and publishing markdown posts using Cursor after your framework is set up." -date: "2025-01-17" +date: "2025-12-14" slug: "how-to-publish" published: true tags: ["tutorial", "markdown", "cursor", "publishing"] @@ -18,9 +18,38 @@ excerpt: "Quick guide to writing and publishing markdown posts with npm run sync Your blog is set up. Now you want to publish. This guide walks through writing a markdown post and syncing it to your live site using Cursor. +## Use the Write Page + +Before creating files manually, try the built-in writing tool at [/write](/write). This page is not linked in navigation. Access it directly by typing the URL. + +The Write page has three columns: + +| Column | Purpose | +| ------------- | ---------------------------------------------------------------------- | +| Left sidebar | Content type selector (Blog Post/Page), Clear, Theme, and Font buttons | +| Center | Full-height writing area with Copy All button | +| Right sidebar | Frontmatter field reference with copy buttons for each field | + +Features: + +- **Font switcher**: Toggle between Serif and Sans fonts +- **Theme toggle**: Matches the rest of the site (dark, light, tan, cloud) +- **localStorage persistence**: Content saves automatically as you type +- **Stats bar**: Word count, line count, and character count +- **Frontmatter reference**: See all available fields with examples and copy them individually + +The Write page does not connect to Convex. It stores content in your browser only. When you finish writing: + +1. Click **Copy All** to copy the full markdown +2. Create a new file in `content/blog/` or `content/pages/` +3. Paste the content +4. Run `npm run sync` + +This workflow works well for drafting posts before committing them to your repo. + ## Create a New Post -In Cursor, create a new file in `content/blog/`: +In Cursor or your favorite IDE, create a new file in `content/blog/`: ``` content/blog/my-new-post.md diff --git a/content/blog/markdown-with-code-examples.md b/content/blog/markdown-with-code-examples.md index 6d43a8a..230d328 100644 --- a/content/blog/markdown-with-code-examples.md +++ b/content/blog/markdown-with-code-examples.md @@ -1,7 +1,7 @@ --- title: "Writing Markdown with Code Examples" description: "A sample post showing how to write markdown with syntax-highlighted code blocks, tables, and more." -date: "2025-01-17" +date: "2025-12-14" slug: "markdown-with-code-examples" published: true tags: ["markdown", "tutorial", "code"] diff --git a/content/blog/setup-guide.md b/content/blog/setup-guide.md index 641c9c6..96fa667 100644 --- a/content/blog/setup-guide.md +++ b/content/blog/setup-guide.md @@ -1,7 +1,7 @@ --- title: "Setup Guide - Fork and Deploy Your Own Markdown Framework" description: "Step-by-step guide to fork this markdown sync framework, set up Convex backend, and deploy to Netlify in under 10 minutes." -date: "2025-01-14" +date: "2025-12-14" slug: "setup-guide" published: true tags: ["convex", "netlify", "tutorial", "deployment"] @@ -43,6 +43,9 @@ This guide walks you through forking [this markdown framework](https://github.co - [Environment Files](#environment-files) - [When to Sync vs Deploy](#when-to-sync-vs-deploy) - [Customizing Your Framework](#customizing-your-framework) + - [Fork Configuration Options](#fork-configuration-options) + - [Option 1: Automated (Recommended)](#option-1-automated-recommended) + - [Option 2: Manual](#option-2-manual) - [Files to Update When Forking](#files-to-update-when-forking) - [Site title and description metadata](#site-title-and-description-metadata) - [Update Backend Configuration](#update-backend-configuration) diff --git a/content/blog/using-images-in-posts.md b/content/blog/using-images-in-posts.md index 1cbb30c..b431f52 100644 --- a/content/blog/using-images-in-posts.md +++ b/content/blog/using-images-in-posts.md @@ -1,7 +1,7 @@ --- title: "Using Images in Blog Posts" description: "Learn how to add header images, inline images, and Open Graph images to your markdown posts." -date: "2025-01-18" +date: "2025-12-14" slug: "using-images-in-posts" published: true featured: true diff --git a/public/images/forkconfig.png b/public/images/forkconfig.png index 6146316..f288576 100644 Binary files a/public/images/forkconfig.png and b/public/images/forkconfig.png differ diff --git a/public/raw/about-this-blog.md b/public/raw/about-this-blog.md index a7a1a52..d9975f7 100644 --- a/public/raw/about-this-blog.md +++ b/public/raw/about-this-blog.md @@ -4,7 +4,7 @@ --- Type: post -Date: 2025-01-16 +Date: 2025-12-14 Reading time: 4 min read Tags: convex, netlify, open-source, markdown, ai, llm --- diff --git a/public/raw/how-to-publish.md b/public/raw/how-to-publish.md index ec9074f..66af638 100644 --- a/public/raw/how-to-publish.md +++ b/public/raw/how-to-publish.md @@ -4,7 +4,7 @@ --- Type: post -Date: 2025-01-17 +Date: 2025-12-14 Reading time: 3 min read Tags: tutorial, markdown, cursor, publishing --- @@ -15,9 +15,38 @@ Tags: tutorial, markdown, cursor, publishing Your blog is set up. Now you want to publish. This guide walks through writing a markdown post and syncing it to your live site using Cursor. +## Use the Write Page + +Before creating files manually, try the built-in writing tool at [/write](/write). This page is not linked in navigation. Access it directly by typing the URL. + +The Write page has three columns: + +| Column | Purpose | +| ------------- | ---------------------------------------------------------------------- | +| Left sidebar | Content type selector (Blog Post/Page), Clear, Theme, and Font buttons | +| Center | Full-height writing area with Copy All button | +| Right sidebar | Frontmatter field reference with copy buttons for each field | + +Features: + +- **Font switcher**: Toggle between Serif and Sans fonts +- **Theme toggle**: Matches the rest of the site (dark, light, tan, cloud) +- **localStorage persistence**: Content saves automatically as you type +- **Stats bar**: Word count, line count, and character count +- **Frontmatter reference**: See all available fields with examples and copy them individually + +The Write page does not connect to Convex. It stores content in your browser only. When you finish writing: + +1. Click **Copy All** to copy the full markdown +2. Create a new file in `content/blog/` or `content/pages/` +3. Paste the content +4. Run `npm run sync` + +This workflow works well for drafting posts before committing them to your repo. + ## Create a New Post -In Cursor, create a new file in `content/blog/`: +In Cursor or your favorite IDE, create a new file in `content/blog/`: ``` content/blog/my-new-post.md diff --git a/public/raw/markdown-with-code-examples.md b/public/raw/markdown-with-code-examples.md index e4176d0..80564a4 100644 --- a/public/raw/markdown-with-code-examples.md +++ b/public/raw/markdown-with-code-examples.md @@ -4,7 +4,7 @@ --- Type: post -Date: 2025-01-17 +Date: 2025-12-14 Reading time: 5 min read Tags: markdown, tutorial, code --- diff --git a/public/raw/setup-guide.md b/public/raw/setup-guide.md index 5a31d93..1bc48dc 100644 --- a/public/raw/setup-guide.md +++ b/public/raw/setup-guide.md @@ -4,7 +4,7 @@ --- Type: post -Date: 2025-01-14 +Date: 2025-12-14 Reading time: 8 min read Tags: convex, netlify, tutorial, deployment --- @@ -40,6 +40,9 @@ This guide walks you through forking [this markdown framework](https://github.co - [Environment Files](#environment-files) - [When to Sync vs Deploy](#when-to-sync-vs-deploy) - [Customizing Your Framework](#customizing-your-framework) + - [Fork Configuration Options](#fork-configuration-options) + - [Option 1: Automated (Recommended)](#option-1-automated-recommended) + - [Option 2: Manual](#option-2-manual) - [Files to Update When Forking](#files-to-update-when-forking) - [Site title and description metadata](#site-title-and-description-metadata) - [Update Backend Configuration](#update-backend-configuration) diff --git a/public/raw/using-images-in-posts.md b/public/raw/using-images-in-posts.md index a7bf1ab..1254fc9 100644 --- a/public/raw/using-images-in-posts.md +++ b/public/raw/using-images-in-posts.md @@ -4,7 +4,7 @@ --- Type: post -Date: 2025-01-18 +Date: 2025-12-14 Reading time: 4 min read Tags: images, tutorial, markdown, open-graph ---