BlogBERTBlogBERTby Inferya

Connect GitHub

For a blog whose source lives in a GitHub repository.

Use this when your blog's source files are in a GitHub repository and your host (GitHub Pages, Vercel, Netlify or similar) builds the site from it. BlogBERT adds each post as a Markdown file, with its images, in the folders you choose. Your host then rebuilds the site the way it does after any other change.

No blog yet? Use the template instead.

Connect

  1. Open Setup in BlogBERT and save your site details.
  2. Under Publishing, press Connect GitHub.
  3. GitHub asks where to install the BlogBERT app. Choose the account that owns your blog, select the repository and press Install.
  4. Back in BlogBERT, pick the repository and the branch your site is built from.
  5. Pick the preset that matches your blog (below) and save.

BlogBERT can only reach the repository you select. To remove it, open GitHub Settings, then Applications.

Pick a preset

Preset Posts go in Images go in Post address
Jekyll _posts assets/images/blog /blog/{slug}/
Hugo content/posts static/images/blog /posts/{slug}/
Astro src/content/blog public/images/blog /blog/{slug}/
Next.js MDX content/blog/{category} public/images/blog /blog/{category}/{slug}
Answer-first Markdown frontend/content/blog frontend/public/blog-images /blog/{slug}/

Jekyll names each file with the date, like 2026-11-02-my-post.md. Hugo and Astro use the post's name, like my-post.md.

Next.js MDX is for categorized MDX blogs using content/blog/<category>/<slug>.mdx and /blog/<category>/<slug> addresses. Enter a category folder that already exists on your site. This preset does not fit every Next.js site. It uses datePublished and dateModified plus the site's answer, author, key facts, FAQ and contact fields instead of the standard Markdown front matter below.

Answer-first Markdown is for blogs that show each post's meta description as its answer and check every post when the site builds. Enter the four folders and addresses like Custom. Q&A pairs become question headings and links to your own site become site addresses.

The post address has to match how your blog builds its pages. BlogBERT opens that address to confirm the post is live.

Folders that do not match

Choose Custom and fill in four things: the folder for posts, the folder for images, the web address images are served from and the address pattern of a post. Write {slug} where the post's name goes. A Jekyll file name can also use {yyyy}, {mm} and {dd}.

Not sure what to enter? The AI prompt asks ChatGPT or Claude to read your repository and answer for you.

Post files

Each post file starts with front matter holding these fields: title, description, date, slug, image, image_alt, canonical, tags. Your blog needs to read Markdown files with front matter. Jekyll, Hugo and Astro all do.

After the first post

BlogBERT commits the post to your branch, then checks your live page. A post shows as published once that page loads with the post's title. Most hosts take a minute or two to rebuild.