Skip to main content

Edit and Delete Blog Post

After publishing blog posts, you will need to update content, fix typos, or remove old posts. This guide shows how to manage them without breaking anything.

Edit / Update Blog Post​

Step 1: Find the Post File​

Go to your project:

blog/
├── 2026-02-28-first-post.md
├── 2026-03-15-tutorial.md
└── authors.yml

Find the file you want to edit. Example: 2026-02-28-first-post.md

Step 2: Open and Edit​

Open the file in VS Code.

You can edit 2 parts:

1. Frontmatter (the top part between ---):

---
slug: first-blog-post
title: First Blog Post
description: Description for SEO
authors: creativitas
tags: [docusaurus, tutorial]
image: img/docusaurus.png
---

What you can change:

  • title: Update the post title - shows on the blog list and post page
  • description: Update the SEO description
  • slug: WARNING - changing the slug changes the URL. Old links will break (404). Avoid changing it after publish unless needed.
  • authors: Change the author ID, or add more: authors: [creativitas, sonandreas]
  • tags: Add or remove tags: tags: [docusaurus, new-tag]
  • image: Change the cover image

2. Content (below the frontmatter):

Edit the markdown content:

# Old content here...

Fix typo, add new section:

## New Section Added

New content here...

Add new image:
![My Image](/img/new-image.png)

Step 3: Save and Preview​

  1. Save the file (Ctrl+S)
  2. If npm run start is running, the browser auto-refreshes
  3. Go to http://localhost:3000/blog and http://localhost:3000/blog/your-slug
  4. Check the changes

Important about the date in the filename:

  • The filename date 2026-02-28-... is used for sorting and the URL if you do not set a slug
  • Changing the date in the filename will change the post order on the blog list (newer date = higher)
  • Changing the date also changes the URL if you do not use a custom slug
  • Best practice: Keep the filename date the same as the publish date, use slug for a custom URL

Example: Update post date (re-publish as new)​

If you want to bump a post to the top as new:

  1. Rename the file: 2026-02-28-first-post.md → 2026-06-10-first-post.md
  2. Keep the same slug: first-blog-post so the URL stays the same
  3. Save - the post now shows as June 10, 2026 on the list

Delete Blog Post​

Step 1: Find the File​

blog/2026-02-28-old-post.md

Step 2: Delete​

  • In VS Code: Right-click the file → Delete
  • Or in File Explorer: Select the file → Delete key

Step 3: Check​

  1. Run npm run start
  2. Go to /blog - the deleted post should be gone
  3. Visiting the old URL /blog/old-post-slug will now show a 404 - This is normal

Rename Blog Post​

To rename the slug or URL:

  1. Open the file: blog/2026-02-28-first-post.md
  2. Change slug: in the frontmatter: 
    ---
    slug: my-new-url
    ---
  3. Optionally rename the file to match: 2026-02-28-my-new-url.md (keeps things organized)
  4. Save

Warning: If the post is already indexed by Google or has been shared, the old URL will 404. You should set up a redirect in docusaurus.config.js if needed, or keep the old slug.

Bulk Management​

  • To draft a post without publishing: Move the file out of the blog/ folder to blog-drafts/, or add draft: true in the frontmatter (if your config supports it) - the post will not show on the production build.
  • To hide but keep the file: Rename it to 2026-02-28-post.md.bak or move it to a backup folder.