GitHub CMS enables companies to create content with visibility in neural networks — ChatGPT, Perplexity, Google AI Overviews. No databases, no monthly SaaS fees, no development team needed. Markdown articles automatically get JSON-LD markup, Open Graph tags, and land in the sitemap on every push to the repository.
Recognize yourself?
GitHub CMS is built for those who need a working, fast, and secure site, rather than endless plugin configuration and subscription fees.
How it works under the hood
GitHub CMS architecture relies on 4 accepted ADRs (Architecture Decision Records). No magic, just engineering pragmatism and strict contracts.
---
title: "How to speed up loading"
slug: "speed-up"
date: "2026-05-22"
schema_type: "Article"
geo:
answerfirst: "Use CDN and SSG."
keyfacts:
- "TTFB affects ranking. verified"
---
<!-- block answer-first –>
To speed up, use Static Site Generation…
<!-- /block answer-first –>
1. The Frontmatter Contract
Every page or article is a Markdown file with a YAML header. This structure is parsed by the gray-matter utility. Fields are strictly typed: if you forget to specify slug or title, GitHub Actions will halt the build and point out the error.
A special geo block allows you to embed semantic annotations directly into the file. During the build (SSG), this information is transformed into a valid JSON-LD graph linking entities, facts, and authors.
name: Build and Deploy
on:
push:
branches: ["main"]
jobs:
build:
runs-on: ubuntu-latest
steps: - uses: actions/checkout@v4 - run: npm install - run: npm run validate - run: npm run build - run: rsync -avz dist/ user@server:/var/www/html/2. Continuous Integration (CI/CD)
GitHub CMS requires no manual builds. With every git push to the main branch, the pipeline triggers. First, the validate.ts script checks all Markdown files against the rules (no secrets, required blocks present, meta tag lengths).
Then Vite SSG runs, rendering Vue components into static HTML. The resulting dist/ folder is copied to your server via SSH. No Node.js or PM2 in production.
Generative Engine Optimization
The era of plain SEO is fading. People don't just look for links on Google; they ask questions directly to ChatGPT, Perplexity, Claude, and Bing Copilot. For your site to appear in their answers (and provide a link to you), your content must be structured specifically. This is called GEO.
-
1Direct answer. The
answer-firstblock gives the AI model a clear, unambiguous answer without fluff or preamble. -
2Fact verification. The
verifiedmarkers tell parsers the fact is backed by sources (E-E-A-T). -
3Linked data. Automatic microdata generation links the article to its Author and Organization.
Generated JSON-LD Payload (Example)
{
"@context": "https://schema.org",
"@graph": [
{
"@type": "WebPage",
"@id": "https://githubcms.ru/#webpage",
"url": "https://githubcms.ru/",
"name": "GitHub CMS",
"isPartOf": { "@id": "https://githubcms.ru/#website" }
},
{
"@type": "Article",
"@id": "https://githubcms.ru/#article",
"headline": "Static site with AI visibility",
"datePublished": "2026-05-22T00:00:00+00:00",
"author": {
"@type": "Person",
"name": "GitHub CMS Team"
}
}
]
}Platform Comparison
How GitHub CMS compares to monoliths and builders.
One Repository — Dozens of Tasks
Thanks to the flexible template system and Markdown, you can adapt the site to any small business or IT project needs.
SaaS Landing Page
Quick launch of a startup presentation page. Integration of lead forms via third-party services, instant loading on mobile devices.
Service / Business Site
For lawyers, consultants, agencies. Service Schema.org generation allows search engines to correctly understand prices and service regions.
Blog / Media Resource
A full-fledged content engine with tags, categories, pagination, and RSS feed generation. Perfect for SEO traffic.
Showcase / Simple Store
Create products as .md files. Product Schema.org is generated automatically. Connect Stripe, PayPal, or local payment iframes.
Tech Documentation
Built-in support for code syntax highlighting, navigational indexes, and structured TechArticle markup.
Multilingual Sites
Organize content by folders (en, es) with automatic hreflang tag generation for proper international SEO.
Complete Knowledge Base & FAQ
Everything you need to know about frontmatter, deploy, JSON-LD, and architecture.
Which Frontmatter fields are required?
title (≤70 chars), description (120-160 chars), slug (latin, digits, hyphens), date (YYYY-MM-DD). Without them, content validation at build time will fail. These fields form the H1, meta-description, URL, and publish date in the sitemap.How does author affect JSON-LD?
author field automatically generates a JSON-LD Person entity with fields: name, url, image, sameAs, worksFor. AI search engines parse this to see who wrote the article, their experience, and affiliations. This is a powerful E-E-A-T signal.What schema_type values are supported?
Article, HowTo (generates complex JSON-LD with steps), FAQPage (extracts Q&A from content), BlogPosting, NewsArticle, TechArticle, Product, Service, WebSite. Build validation strictly checks against this list.Why is the raw_html field needed?
raw_html: true flag disables standard markdown-it rendering. The body of the .md file is used directly as pure HTML. This is critical for landing pages (like the one you are reading) built with Bootstrap classes and inline styles.How do tags and categories affect the site?
tags and category fields automatically generate routes like /tag/name/ and /category/name/. Each becomes a paginated list of articles. In JSON-LD, tags are passed to about/mentions, and categories to articleSection. Validation ensures tags is an array.How is Frontmatter validated during build?
Can I add custom Frontmatter fields?
price: 1500 or custom_color: "#ff0000" and use it in your template. Standard fields are handled by useSeo.ts.What happens if Frontmatter is empty?
How can a developer launch a site without a designer?
content/, and git push. GitHub Actions automatically builds and deploys the site to your VPS. No Figma, no UI developer needed — the box includes a mobile-ready UI with correct typography and spacing.How much does it cost for a small business?
Do I need a programmer to regularly update articles?
content/blog/ folder, paste text based on the template, and commit. The site updates automatically in the background in 2-3 minutes.Is a static site secure compared to WordPress?
Fundamental Advantages of Static Architecture
Moving away from classic CMS is not just about saving on hosting. It is a fundamentally new approach to security, speed, and business independence from paid plugin ecosystems.
The Design Problem
Many tech specialists hesitate to hire designers just to build a product landing page. They can code, but don't want to spend weeks on visual systems, grids, and FAQ blocks. GitHub CMS removes this friction: instead of a blank canvas, you get a pre-designed section system that can be improved iteratively.
The Cost Problem
When starting a business, every subscription hurts. Usually, a site brings a cascade of costs: template, builder, premium SEO add-on, CDN, antispam, and someone to fix it all. A static site avoids this cascade: the infrastructure is simpler, and the TCO is significantly lower.
The Maintenance Problem
In traditional systems, traffic spikes mean stress: tweaking Redis, fighting slow SQL queries, and worrying about DDoS. The static paradigm solves this. Serving pre-generated files via Nginx or CDN allows the project to handle colossal loads without configuration changes.