How to Upload Blog Posts
How to Upload Blog Posts in the Development Environment
This guide walks internal team members through the complete workflow for creating, uploading, and translating blog posts using our custom Content Management System (CMS). By following these steps, you can ensure a consistent and efficient publishing process.
Workflow Summary
Step | Action |
1 | Write your blog content |
2 | Format content using Markdown |
3 | Paste Markdown into the CMS editor |
4 | Click "Translate" to generate translations |
5 | Review, save, and publish |
Prerequisites
Before you begin, make sure you have the following ready:
•CMS Access: Valid login credentials for the development environment CMS.
•Content: Your blog post content, written and ready for formatting.
•Markdown Knowledge: Convert your article content into a Markdown format
Step 1: Write Your Content
Step 2: Convert Content to Markdown Format
Once your content is finalized, convert it to Markdown format. Our CMS uses Markdown for rendering, so proper formatting is essential. Below is a quick reference table for common Markdown syntax:
Element | Markdown Syntax | Example Output |
Heading 1 | # Heading | # Heading |
Heading 2 | ## Heading | ## Heading |
Heading 3 | ### Heading | ### Heading |
Bold | **bold text** | bold text |
Italic | *italic text* | italic text |
Unordered List | - Item or * Item | - Item |
Ordered List | 1. Item | 1. Item |
Link | [text](URL) | |
Image |  |  |
Code Block | code | code |
Blockquote | > quoted text | > quoted text |
Step 3: Paste Content into the CMS
With your Markdown-formatted content ready, you can now upload it to the CMS.
1.Log in to the development CMS: https://admin.prod.ops.butterfly-effect.dev/blog
2.Navigate to the Blog Management section in the sidebar.
3.Click the "Add Blog" Button
4.Paste your Markdown content directly into the content editor.
5.Fill in the required metadata fields, such as:
•UID
•Category
•Cover URL
Step 4: Translate Your Content
Our CMS includes a built-in translation feature that enables multi-language support for blog posts.
1.After pasting your content, locate the "Translate" button at the top right of the page.
2.Click the "Translate" button to initiate automatic translation.
3.The system will generate translations for all supported languages.
4.Review each translation carefully.
Note: If you notice any translation errors or awkward phrasing, you can edit the translated content directly in the CMS or raise it up to a helpful colleague lol.
Step 5: Save and Publish
Once you are satisfied with both the original content and its translations, save your work.
1.Click the "Save" button to save your blog post as a draft.
2.Preview your post by clicking on the UID in the blog management view.
3.Review the formatting, images, and links to ensure everything displays correctly.
4.When ready, you can publish the post immediately.