x/wiki
1
0
Fork 0
mirror of https://github.com/waynesutton/markdown-site.git synced 2026-01-12 04:09:14 +00:00
Code Issues Packages Projects Releases Wiki Activity

updated fork-confg post image

Browse Source
This commit is contained in:
Wayne Sutton
2025-12-20 23:12:40 -08:00
parent 5b356ff1a8
commit 662c28057c
11 changed files with 76 additions and 12 deletions
Download Patch File Download Diff File Expand all files Collapse all files

2
content/blog/about-this-blog.md
View File

@@ -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"]

33
content/blog/how-to-publish.md
View File

@@ -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

2
content/blog/markdown-with-code-examples.md
View File

@@ -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"]

5
content/blog/setup-guide.md
View File

@@ -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)

2
content/blog/using-images-in-posts.md
View File

@@ -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

BIN
public/images/forkconfig.png
View File

Binary file not shown.
Side by Side Swipe Overlay

Before

Width:  |  Height:  |  Size: 1.8 MiB

After

Width:  |  Height:  |  Size: 1.3 MiB

2
public/raw/about-this-blog.md
View File

@@ -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
---

33
public/raw/how-to-publish.md
View File

@@ -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

2
public/raw/markdown-with-code-examples.md
View File

@@ -4,7 +4,7 @@
---
Type: post
Date: 2025-01-17
Date: 2025-12-14
Reading time: 5 min read
Tags: markdown, tutorial, code
---

5
public/raw/setup-guide.md
View File

@@ -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)

2
public/raw/using-images-in-posts.md
View File

@@ -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
---