mirror of
https://github.com/waynesutton/markdown-site.git
synced 2026-01-12 04:09:14 +00:00
update: added agentmail to readme, updated home links
This commit is contained in:
@@ -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
|
||||
|
||||
@@ -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"]
|
||||
|
||||
@@ -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
|
||||
|
||||
|
||||
@@ -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"]
|
||||
---
|
||||
|
||||
|
||||
@@ -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.
|
||||
|
||||
@@ -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.
|
||||
|
||||
|
||||
Reference in New Issue
Block a user