Blog

Blog is a publishing system for creating and sharing content with your audience. Write posts in Markdown, control visibility with draft and published states, and engage readers through a moderated comment system.

What is a Blog Post?

A blog post represents a piece of content you create and optionally publish. Each post includes:

FieldDescription
TitleThe headline of your post
BodyMain content written in Markdown
ExcerptOptional summary for previews and SEO
StatusDraft, published, or archived
ProjectOptional link to a project
TagsCategories for organization

Posts support full Markdown formatting including code blocks with syntax highlighting, images, links, and embedded media from YouTube, Twitter, and GitHub Gists.

Post Lifecycle

Blog posts progress through lifecycle states:

StatusDescription
DraftWork in progress, not visible to the public
PublishedLive and accessible via public URL
ArchivedHidden from normal views, data preserved

Draft State

New posts start as drafts. In this state:

  • Content is visible only in your dashboard
  • No public URL exists
  • You can edit freely without affecting published content
  • AI-powered improvements are available

Published State

When you publish a post:

  • A unique public URL is generated
  • The post appears on your public profile
  • SEO metadata becomes active
  • Comments can be enabled if configured

Archived State

Archive posts you no longer want visible:

  • Removes from public view
  • Preserves all data and history
  • Can be restored to draft status

Public URLs

Published posts are accessible at unique public URLs:

  • Single-user mode: /blog/{public-slug}
  • Platform mode: /{username}/{slug}

The public slug is generated from your post title with a timestamp suffix to ensure global uniqueness.

SEO Optimization

Each post supports SEO fields:

FieldDescription
Meta TitleCustom title for search results (defaults to post title)
Meta DescriptionDescription for search results (defaults to excerpt)

When published, posts include:

  • OpenGraph tags for social sharing
  • Twitter Card metadata
  • JSON-LD structured data for search engines
  • Proper heading hierarchy

Comments System

Enable comments to engage with your readers. The comment system supports:

Comment Visibility

SettingDescription
DisabledNo comments allowed
PublicComments visible to all readers
PrivateComments visible only to you

Moderation

Comments can require approval before appearing:

  • Pending - Awaiting review
  • Approved - Visible to readers
  • Rejected - Hidden from public view
  • Spam - Marked as spam

When moderation is enabled, new comments appear as pending until you approve them.

Anonymous Comments

Readers can comment without an account by providing:

  • Name (required for anonymous)
  • Email (required for anonymous)

Authenticated users can comment with their account, which links their profile.

Email Notifications

The system sends email notifications for:

  • New comments on your posts
  • Comment approval to submitters (when you approve their comment)

Rate Limiting

Public comment endpoints are rate limited to prevent abuse:

  • 5 comments per hour per IP address

AI-Powered Improvements

Drafts can be enhanced using AI assistance. Select from improvement focuses:

FocusDescription
GrammarFix spelling and grammatical errors
SEOOptimize for search visibility
ToneAdjust writing style and voice
ExpandAdd more detail and depth

You can combine multiple focuses and provide custom instructions for targeted improvements.

AI improvements are rate limited to 5 requests per hour per user.

Project Association

Link blog posts to projects to:

  • Show related content on project pages
  • Group posts by project in your dashboard
  • Provide context for readers

Posts can exist without a project association for general content.

Tags

Organize posts with tags for:

  • Filtering in the dashboard
  • Categorization on your public profile
  • Content discovery

Tags are shared across your team and work the same as tags on other objects (notes, tasks, links).

Workflow Write-ups

A special post type for documenting n8n workflows:

FieldDescription
WorkflowLink to an uploaded workflow
PrerequisitesWhat users need before using the workflow
Compatibilityn8n version and compatibility notes

Workflow write-ups appear in the workflows section and help users understand how to use your automation templates.

Public Profile Display

Published blog posts appear on your public profile:

  • Listed in the Blog section
  • Sorted by publish date (newest first)
  • Includes excerpt and publish date
  • Links to full post view

Your profile URL is /{username} in platform mode or the root domain in single-user mode.

Activity Logging

All blog operations are logged for auditing:

  • Post creation, updates, and deletion
  • Publishing and unpublishing
  • Comment submission and moderation
  • AI improvement requests

View the activity log in your team settings to track blog history.

Best Practices

  1. Write clear titles - Help readers understand what the post covers
  2. Add excerpts - Improve SEO and social sharing previews
  3. Use SEO fields - Customize how your post appears in search results
  4. Enable comment moderation - Review comments before they appear publicly
  5. Link to projects - Connect related content for better organization
  6. Use tags consistently - Build a useful categorization system
  7. Archive instead of delete - Preserve content history

Next Steps

Was this page helpful?
Blog | Documentation | DoerPath