How to Create a Blog Post

Blog posts let you share content with your audience. This guide walks you through creating a new post with formatting, tags, and project associations.

Prerequisites

Before you begin:

• You must be signed in to your account
• You must be a team owner (blog creation is owner-only)

Steps

Step 1: Navigate to Blog

From the sidebar, click Blog to view your existing posts.

Step 2: Click New Post

Click the New Post button in the top right corner to open the post editor.

Step 3: Enter Post Details

Fill in the required fields:

Step 4: Add Content

Write your post content in the body field using Markdown:

## Introduction

Your intro paragraph here.

## Main Section

Content with **bold** and *italic* text.

- Bullet points
- More points

### Code Example

```javascript
console.log('Hello World');

The editor supports:

- Headers (## and ###)
- Bold and italic text
- Bullet and numbered lists
- Code blocks with syntax highlighting
- Links and images
- Tables

### Step 5: Configure Comment Settings

Expand the comment settings to configure:

| Setting | Description |
|---------|-------------|
| **Enable Comments** | Toggle comment submission on/off |
| **Visibility** | Disabled, Public, or Private |
| **Require Approval** | Comments wait for moderation before appearing |

### Step 6: Save Your Post

Choose how to save:

| Action | Result |
|--------|--------|
| **Save Draft** | Saves as draft, redirects to edit page |
| **Save & Publish** | Saves and immediately publishes |

## Expected Result

After creating the post:

- The post appears in your blog list
- Drafts show a "Draft" badge
- Published posts have a public URL
- You're redirected to the edit page for further changes

## Markdown Formatting Guide

### Text Formatting

```markdown
**Bold text**
*Italic text*
~~Strikethrough~~
`inline code`

Links and Images

[Link text](https://example.com)
![Alt text](https://example.com/image.jpg)

Code Blocks

```javascript
function example() {
  return 'Hello';
}
```

Supported languages include: JavaScript, TypeScript, Python, Go, Rust, CSS, HTML, JSON, YAML, SQL, Bash, and more.

Lists

- Unordered item
- Another item

1. Ordered item
2. Second item

Tables

| Column 1 | Column 2 |
|----------|----------|
| Cell 1   | Cell 2   |

Embedded Media

Links to supported platforms are automatically embedded:

Paste the URL on its own line to enable auto-embedding.

Adding Tags

1. Scroll to the Tags section
2. Click to open the tag selector
3. Select existing tags or create new ones
4. Tags help organize and filter your posts

Associating with a Project

1. Open the Project dropdown
2. Select from your available projects
3. Linked posts appear on the project page

This is optional but helps group related content.

Troubleshooting

"Title is required" error

The title field cannot be empty. Enter a descriptive headline.

"Only team owners can create blog posts" error

Blog creation is restricted to team owners. Contact your team owner to create posts.

Rate limit exceeded

You can create 10 posts per hour. Wait before creating more.

Next Steps

After creating your post:

• Edit your post to make changes
• Publish your post when ready
• Manage comments as they arrive

Related

• Blog overview - Learn about the blog system
• How to create a project - Create projects to associate with posts