Static Site Generator or Hosted Publishing? A Guide for Markdown Writers

Updated

If you write in Markdown and want a website, there are two broad routes: build the site yourself with a static site generator, or publish the files to a hosted platform that turns them into pages. Both keep your content as Markdown. They differ in who does the work around it.

Building a static site

A static site generator — Hugo, Jekyll, Quartz and many others — reads a folder of Markdown files and produces HTML pages. You then deploy that output to a host of your choice.

What it involves:

  • Choosing and configuring a generator and a theme.
  • Keeping templates, dependencies and the build working over time.
  • Setting up hosting and deployment, often through CI.
  • Adding extra services for things the generator doesn’t do, such as payments or memberships.

What you get: complete control over design, structure and output.

Publishing on a hosted platform

A hosted Markdown platform takes the files as they are and publishes them. With Sentilis, you install the CLI (or the Obsidian plugin), log in, and sync a folder:

sentilis sync ./my-content

What it involves:

  • Following the platform’s folder conventions — with Sentilis, press/, bio/, market/, prime/ and gallery/.
  • Adding a short settings block to each file.

What you get: hosting, layouts and features like checkout and memberships, with nothing to build or maintain.

Compared

Static site generatorHosted platform (Sentilis)
Content formatMarkdown filesMarkdown files
SetupGenerator, theme, hostingAccount, CLI or plugin
Ongoing maintenanceBuild, dependencies, hostingNone on your side
Design controlCompletePlatform layouts
Commerce and membershipsExtra servicesIncluded
Where files liveYour projectYour disk or repository

How to decide

Choose a static site generator if you enjoy maintaining a code project, need a design that no platform offers, or want to control every byte of the output.

Choose a hosted platform if you want to spend your time writing, need posts, docs, a bio and products in one place, and prefer not to maintain a build.

Either way, your content stays in Markdown — so the decision is reversible. You can move the same files from one route to the other later.

Publish your Markdown without building a site →

Keep reading

Guides →

Your Markdown is already your content. Now give it a home on the web.

Publish your Markdown →