Overview

Posts are the core content unit in Postnomic. Each post belongs to a blog and moves through a defined lifecycle from draft to publication. This guide covers how to create and configure a post.

Creating a New Post

From your blog dashboard, click New Post to open the post editor. Each post has several fields you can configure:

Title

The headline of your post displayed in listings and at the top of the post page. Choose a clear, descriptive title that tells readers what to expect.

Slug

A URL-friendly identifier for the post (e.g., getting-started-with-docker). The slug is auto-generated from the title but can be customized. Once published, avoid changing the slug as it affects URLs in the Client SDKs and any external links.

Content

Write your post content using the Markdown editor. Postnomic supports standard Markdown syntax including:

• Headings — ## Section Title
• Bold and italic — **bold** and *italic*
• Code blocks — Fenced blocks with language identifiers for syntax highlighting
• Lists — Ordered and unordered
• Links and images — Standard Markdown syntax
• Tables — Pipe-delimited tables
• Blockquotes — > Quoted text

Example:

## Introduction

This post covers the basics of **containerization** with Docker.

```bash
docker build -t myapp .
docker run -p 8080:80 myapp

Key benefits:

• Consistent environments
• Easy deployment
• Scalable architecture

### Excerpt

A short summary of the post, typically 1-3 sentences. The excerpt is displayed in blog listings and used for SEO meta descriptions. If left empty, the Client SDKs will use the beginning of the post content as a fallback.

## Images

Each post supports three types of images:

### Cover Image

The main image displayed at the top of the post and as a large preview in blog listings. Upload a high-resolution image (recommended: 1200x630 pixels) that represents the post's topic.

### Thumbnail Image

A smaller version used in compact listing views and related post widgets. If not provided, a scaled version of the cover image may be used.

### Share Image

The image used when the post is shared on social media (Open Graph / Twitter Cards). Optimized dimensions are 1200x630 pixels. If not set, the cover image is used.

All images are uploaded to Azure Blob Storage and served through the API's blob proxy, ensuring consistent delivery regardless of your hosting setup.

## Metadata

### Categories and Tags

Assign one or more categories and tags to organize your post. Categories provide broad topic grouping, while tags offer fine-grained classification.

### Author

The post author is automatically set to the current user. Admins and editors can reassign authorship to any blog member.

## Saving and Previewing

- **Save as Draft** — Saves the post without publishing. You can continue editing at any time.
- **Preview** — View how the post will appear to readers before publishing.
- **Publish** — Makes the post publicly visible. See the **Post Lifecycle** guide for all available states.

Posts are identified by a `PublicId` (a `Guid`) in API responses, keeping internal database IDs hidden.