Blog & Help Center

How to move your blog from another website to TeleportHQ with ChatGPT or Claude

How to move your blog from another website to TeleportHQ with ChatGPT or Claude

In TeleportHQ, your own AI tool can move a blog you publish elsewhere, such as WordPress, Medium, Substack, Ghost, Squarespace or Wix: copy the prompt below into an AI that can browse the web, such as Claude Code, Cursor or ChatGPT. It asks for your blog's web address, finds every post through the feed and the sitemap, reads each one, downloads its pictures, writes one Markdown file per post with its date, author, tags, main picture and old address, puts the posts in folders that become your categories, and zips the folder. Drop that ZIP on the Import Posts button in the Blog panel, review what will be created, and your posts are live at /blog, dated as they were, with the old addresses redirected to the new pages.

Before you start

Steps

1. Copy the prompt

Copy the whole block below. It tells the AI to find every post at your address, what to keep from each one, where the pictures go, how to record the date, the author and the old address, and to end by zipping the folder.

You are moving my blog to TeleportHQ as Markdown files. First ask me, and wait for the answer: the web address of the blog to move (for example https://example.com/blog). Ask nothing else.

Then open that address and find every post: read the feed first (/feed, /rss.xml, /feed.xml, /atom.xml, or the feed link in the page's head), then /sitemap.xml and /sitemap_index.xml, then the blog's list pages with every "older posts", "next" and page-number link, until nothing new turns up. Tell me how many posts and categories you found before you write anything.

Read every post page and write it as one Markdown file, keeping what a reader sees: the title, the text, headings, lists, tables, quotes, code blocks with their language, embedded videos as their links, links and pictures. Do not rewrite, shorten or improve the text.

Deliver this folder, zipped as blog.zip:

blog/
  news/
    _category.md
    our-new-office.md
    pictures/
      our-new-office-cover.jpg
      our-new-office-1.jpg
  guides/
    choose-a-standing-desk.md

Rules:
- One folder per category of the old blog, one .md file per post. A post in several categories goes in the folder of its first one, with the others listed under tags. A blog without categories puts every post at the top of the folder.
- Name every folder and file with lowercase letters, digits and dashes only, no numbers in front: your site lists posts by date. Take the file name from the post's old address when it has a readable one: our-new-office.md becomes "Our new office" at /blog/our-new-office.
- File names must be unique across all folders: each is its post's web address.
- Each post starts with front matter between two --- lines: title (the old title), description (the old excerpt or subtitle, or the first sentence), date (the old published date, written 2026-03-15), last_verified (the old updated date when the page shows one), author (the old author's name), tags (the old tags, as [design, remote-work]), image (the main picture, as pictures/our-new-office-cover.jpg), image_alt (what the main picture shows), and redirect_from (a list of the post's old web address paths, such as [/2024/03/15/our-new-office]).
- Add a _category.md (name, description, redirect_from with the category's old address paths) when the folder's name is not the old category's name.
- Download EVERY picture of a post, its main picture included, into the pictures folder next to it, named after the post: pictures/our-new-office-cover.jpg for the main picture, then pictures/our-new-office-1.jpg, -2.jpg, and so on in reading order, keeping each picture's format (png, jpg, gif, webp). Put each one in the text where it was: ![the picture's alt text, or one sentence saying what it shows](pictures/our-new-office-1.jpg).
- Link to another post of the blog with a Markdown link whose address is its file's path, relative to the current file: ../guides/choose-a-standing-desk.md. Keep links to other websites as they are.
- Leave out menus, headers, footers, share buttons, "related posts" boxes, comments, newsletter forms, cookie notices and anything else that is not the post.
- Finish by zipping the blog folder. Then tell me how many posts and pictures you wrote, and name any page you could not read or picture you could not download.
- If you cannot download files, keep each picture's full web address in the Markdown instead, as ![alt text](https://…) and image: https://…, and tell me at the end that the pictures stayed on the old site.

2. Give it to your AI and answer its question

  1. Open your AI tool where it can browse the web and save files: Claude Code or Cursor in an empty folder, or a ChatGPT conversation with browsing on.
  2. Paste the prompt and send it.
  3. Answer its one question with your blog's web address, for example https://brightly.app/blog.
  4. Let it work. It reads the posts, downloads the pictures, writes the files, then zips the blog folder into blog.zip. If your tool can't make a ZIP, zip the blog folder yourself with your computer's compress command.

3. Check the ZIP

Open the blog folder before you import it and check:

  • The count matches: as many .md files as your old blog has posts. Open two or three and compare them with the old pages.
  • Every post starts with a title, a date and a redirect_from between two --- lines. The date is the old published date, written like 2024-03-15; the redirect_from paths are the old addresses without the domain.
  • The main picture is named under image and sits in the pictures folder next to the post, with the other pictures, at the paths the post points to. If the AI said the pictures stayed on the old site, the posts point to web addresses instead; they show as long as the old site is online.
  • Every file name is different from every other, in every folder: the file name is the post's address.

4. Import it

  1. Open your project in the TeleportHQ editor.
  2. In the left sidebar, click Blog.
  3. At the top right of the Blog panel, click the upload arrow (tooltip Import Posts). While the list is empty, the panel also offers Import posts below Create Post.
  4. Drop blog.zip on the box, or click the box to choose it. "Reading the file…" shows while TeleportHQ reads it.
  5. Read the plan. Nothing is written yet. It counts what the import will do, for example "120 articles", "5 categories from the folders", "300 pictures to upload to your files" and "120 old addresses to lead to their new pages, with permanent redirects". A box headed with a number of problems lists files that won't be imported, and a box of notes lists, file by file, what will be left out or changed. The messages are explained under Troubleshooting.
  6. Leave Publish imported articles on to put the posts live, or turn it off to save them as drafts.
  7. Click Import followed by the number, for example Import 120 articles. The bar shows Creating categories, Uploading pictures, then Writing articles, and a message sums it up, for example "Import finished: 120 posts added, 5 categories created, 300 pictures in your files, 120 old addresses redirected".

5. Switch the address and read it on your site

  1. Publish your site. See How to publish a web app. The redirects reach your live site when you publish; after that, new and edited posts show within seconds, without publishing again.
  2. Open /blog on your site: the posts are listed newest first, with their old dates. Open an old address, such as https://your-site.com/2024/03/15/our-new-office: it lands on the new post.
  3. Point your old blog's domain at your TeleportHQ site when you are ready, so the old links in search results and newsletters keep working. See How to connect your own domain.
  4. For a wrong title, picture or paragraph, fix the .md file, or ask your AI to, then zip the folder and import it again. Posts are matched by their address: a changed file updates its post in place, a new file is added, and the rest stay as they are. See Import again to update.

Check that it worked

  • The categories show as pills at the top of the Blog panel.
  • Open a post in the panel: its date is the old one, its author is on your authors list, and its main picture, pictures and links are in place.
  • In Project settings (cog, bottom left) → SEO & social → Search engines → Custom Redirects, the old addresses are listed, each leading to its new post.
  • On your live site, /blog lists the posts by date, and each opens at /blog/ followed by its file name.

Troubleshooting

The AI found far fewer posts than your blog has A feed lists only the latest posts, and some blogs load older posts as you scroll. Give the AI the address of the sitemap (/sitemap.xml) or of the archive pages, and ask it to continue from there. If the old platform can export your posts (WordPress, Ghost, Substack and Medium can), give the AI the export too.

Every post shows today's date The posts have no date in their front matter, so each was dated at its import. Ask the AI to add date with each post's old published date and import the ZIP again: the posts are updated in place.

The authors are wrong or missing An author that matches a name on your authors list credits that author; another name becomes the post's own author. A post without an author gets your list's default author. See How to add authors to your posts and articles.

"No Markdown articles found" The ZIP holds no .md files outside left-out folders (those whose names start with _ or .). Open the ZIP and check that the posts are there and that their folders are named without a leading _ or ..

A note says a picture "is not in the bundle, dropped" The post points to a picture that isn't in the ZIP at that path, usually one the AI could not download. Save the picture from the old page yourself, put it next to the post at that path, and import again.

The plan says pictures are .avif (or .heic, .heif, .bmp, .tif, .tiff) "which TeleportHQ cannot upload" TeleportHQ doesn't upload pictures in those formats, so the import leaves them out of the posts. Convert them to .png, .jpg or .webp, change the picture paths in the posts to the new file names, zip the folder again and import it.

A category's old address is not redirected, and the import's notes say so A category's old addresses need category pages. Turn on Category Pages in the Blog's settings (Settings → Listing) and import again. See How to use blog categories, tags and related posts.

Good to know

  • Keep the old site online until the switch is done. The AI reads it while it works, and posts whose pictures stayed on the old site keep showing from there.
  • Old addresses become permanent redirects. Each path under redirect_from becomes a permanent redirect (301) to the post's new page, and importing again keeps them up to date. A * stands for any characters: /2024/*/our-new-office takes every old address ending that way. See Old addresses become permanent redirects.
  • Comments don't move. The import brings the posts, not the comments under them.
  • What a re-import replaces. A post's title, text, excerpt, main picture, categories, tags, SEO title and description come from the file again, so a change you made to those in TeleportHQ is replaced. Its author, place in its category, related posts, status and dates change only when the file sets them. Its address never changes.
  • The Help Center moves the same way. See How to move your help center from another website to TeleportHQ with ChatGPT or Claude.
Share

Related Articles

How to import Markdown files into your blog or help center

In TeleportHQ, click the Import button in the Blog or Help Center panel and drop a Markdown file or a ZIP of Markdown files; folders become categories, front matter sets the title, date, order and more, pictures next to the files are uploaded, and you review a plan before anything is written.

How to import or export blog posts

In TeleportHQ, you import Blog posts or Help Center articles from a CSV or JSON file with the Import button at the top of the panel, or a Markdown file or ZIP of Markdown files, and download them all as CSV or JSON with More → Export Posts on a Trial, Pro or Premium plan.

How to add a blog to your site

In TeleportHQ, click Plugins in the editor's left sidebar, click Blog, switch on Blog enabled and confirm in the Activate Blog window; TeleportHQ builds a blog listing at /blog and a page for every post, and asks first if a Presentation Website has to become a web app.

How to move your help center from another website to TeleportHQ with ChatGPT or Claude

To move a help center from Intercom, Zendesk, Help Scout, Crisp, GitBook, Notion or any other website into TeleportHQ, copy the prompt in this article into an AI tool that can browse the web, such as Claude Code, Cursor or ChatGPT; it reads every article at the address you give it, downloads the pictures, writes one Markdown file per article in folders that become your categories with the old addresses as redirects, and zips them for the Import Articles button in the Help Center panel.

How to add authors to your posts and articles

In TeleportHQ, open Blog Settings (or Help Center Settings), click Authors next to Author Box, add each author with a name, photo and bio, then pick the author in a post's Author field or credit many posts at once with Set author….

How to find and fix broken links on your site

In the TeleportHQ editor, click the yellow issues button at the top left (for example 1 issue) to open the Issues window, which lists every link on your pages, Blog posts and Help Center articles that leads nowhere, with a button that takes you to each one, even before you publish.