update: added agentmail to readme, updated home links

This commit is contained in:
Wayne Sutton
2025-12-27 16:03:18 -08:00
parent a87db9d171
commit 47934cd382
23 changed files with 115 additions and 189 deletions

View File

@@ -3,7 +3,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-12-14"
slug: "about-this-blog"
published: true
published: false
tags: ["convex", "netlify", "open-source", "markdown", "ai", "llm"]
readTime: "4 min read"
featured: false

View File

@@ -1,7 +1,7 @@
---
title: "Git commit message best practices"
description: "A guide to writing clear, consistent commit messages that help your team understand changes and generate better changelogs."
date: "2025-01-17"
date: "2025-12-14"
slug: "git-commit-message-best-practices"
published: true
tags: ["git", "development", "best-practices", "workflow"]

View File

@@ -4,6 +4,7 @@ description: "Complete guide to setting up AgentMail for newsletters and contact
date: "2025-12-27"
slug: "how-to-use-agentmail"
published: true
image: images/agentmail-blog.png
tags: ["agentmail", "newsletter", "email", "setup"]
---
@@ -35,11 +36,11 @@ In the AgentMail dashboard, navigate to API settings and copy your API key. You'
In your Convex dashboard, go to Settings > Environment Variables and add:
| Variable | Description | Required |
|----------|-------------|----------|
| `AGENTMAIL_API_KEY` | Your AgentMail API key | Yes |
| `AGENTMAIL_INBOX` | Your inbox address (e.g., `markdown@agentmail.to`) | Yes |
| `AGENTMAIL_CONTACT_EMAIL` | Contact form recipient (defaults to inbox if not set) | No |
| Variable | Description | Required |
| ------------------------- | ----------------------------------------------------- | -------- |
| `AGENTMAIL_API_KEY` | Your AgentMail API key | Yes |
| `AGENTMAIL_INBOX` | Your inbox address (e.g., `markdown@agentmail.to`) | Yes |
| `AGENTMAIL_CONTACT_EMAIL` | Contact form recipient (defaults to inbox if not set) | No |
**Important:** Never hardcode email addresses in your code. Always use environment variables.
@@ -152,8 +153,8 @@ Submissions are stored in Convex and sent via AgentMail to your configured recip
### Frontmatter options
| Field | Type | Description |
|-------|------|-------------|
| Field | Type | Description |
| ------------- | ------- | ------------------------------------- |
| `contactForm` | boolean | Enable contact form on this post/page |
## Frontmatter options
@@ -165,7 +166,7 @@ Control newsletter signup display per post/page:
```markdown
---
title: "My Post"
newsletter: true # Show signup (default: follows siteConfig)
newsletter: true # Show signup (default: follows siteConfig)
---
```
@@ -174,7 +175,7 @@ Or hide it:
```markdown
---
title: "My Post"
newsletter: false # Hide signup even if enabled globally
newsletter: false # Hide signup even if enabled globally
---
```
@@ -195,10 +196,10 @@ All AgentMail features require these Convex environment variables:
## CLI commands
| Command | Description |
|---------|-------------|
| `npm run newsletter:send <slug>` | Send a blog post to all subscribers |
| `npm run newsletter:send:stats` | Send weekly stats summary to your inbox |
| Command | Description |
| -------------------------------- | --------------------------------------- |
| `npm run newsletter:send <slug>` | Send a blog post to all subscribers |
| `npm run newsletter:send:stats` | Send weekly stats summary to your inbox |
## Troubleshooting

View File

@@ -1,9 +1,10 @@
---
title: "How to use Firecrawl"
description: "Import external articles as markdown posts using Firecrawl. Get your API key and configure environment variables for local imports and AI chat."
date: "2025-01-20"
date: "2025-12-20"
slug: "how-to-use-firecrawl"
published: true
image: images/firecrwall-blog.png
tags: ["tutorial", "firecrawl", "import"]
---

View File

@@ -9,10 +9,8 @@ order: 4
You found the contact page. Nice
## Contact form demo
This form does not work in production and AgentMail to send emails. See <a href="/how-to-use-agentmail"> How to use AgentMail with Markdown Sync for details.>
<!-- contactform -->
## The technical way
This site runs on Convex, which means every page view is a live subscription to the database. You are not reading cached HTML. You are reading data that synced moments ago.
If you want to reach out, here is an idea: fork this repo, add a contact form, wire it to a Convex mutation, and deploy. Your message will hit the database in under 100ms. No email server required.

View File

@@ -4,12 +4,29 @@ slug: newsletter
published: true
order: 15
showInNav: true
newsletter: true
newsletter: false
---
# Newsletter
# Newsletter Demo Page
Stay updated with the latest posts and updates from the markdown sync framework.
This is a demo newsletter page available at `/newsletter`. The newsletter feature uses AgentMail for email infrastructure.
<!-- newsletter -->
## About AgentMail
This newsletter integration is powered by AgentMail, which provides email infrastructure for the markdown blog framework.
AgentMail Newsletter integration features:
- Newsletter subscriptions and sending
- Contact forms on any post or page
- Automated weekly digests
- Developer notifications
- Admin UI for subscriber management
- CLI tools for sending newsletters and stats
For complete setup instructions and detailed documentation, see the [How to use AgentMail with Markdown Sync](/blog/how-to-use-agentmail) guide.
## What you will get
@@ -19,7 +36,7 @@ When you subscribe, you will receive:
- Updates about new features and improvements
- Tips and tricks for getting the most out of markdown sync
## Subscribe
## Subscribe Demo
Use the form below to subscribe to our newsletter. We respect your privacy and you can unsubscribe at any time.