Блог на C# у 2026 році: технічний блог на ASP.NET Core та Minimal APIs
Покроковий посібник зі створення блогу на C# і .NET 10: дописи в Markdown із front matter, потокобезпечне сховище з гарячим перезавантаженням, сторінки з компонентів Razor, output caching і RSS-стрічка.

Технічний блог на C# не потребує ні CMS, ні бази даних. Достатньо теки з файлами Markdown, одного сервісу-синглтона, який розбирає їх під час запуску, кількох ендпоінтів Minimal API, що повертають HTML, і RSS-стрічки. У .NET 10, релізі з довгостроковою підтримкою (LTS), що вийшов у листопаді 2025 року, майже все необхідне вже входить до фреймворку, а решту закривають два зрілі пакети NuGet.
Вебпроєкт на .NET 10, Markdig для перетворення Markdown на HTML, YamlDotNet для front matter, незмінне сховище дописів у пам'яті з перезавантаженням після зміни файлу, ендпоінти Minimal API, що повертають сторінки через RazorComponentResult, output caching з інвалідацією за тегами та стрічка RSS 2.0 на базі System.ServiceModel.Syndication. Увесь рушій займає менше ніж 300 рядків C#.
Чому Minimal API, а не генератор статичних сайтів
Генератори на кшталт Hugo чи Jekyll створюють HTML-файли під час збирання. Вони швидкі й дешеві, проте будь-яка поведінка поза шаблонами (відкладена публікація, JSON API для мобільного застосунку, окремі стрічки для тегів, інтеграція з аналітикою) перетворюється на плагін мовою, якою .NET-розробник щодня не користується.
Блог на ASP.NET Core зберігає контент у звичайних файлах Markdown у Git, рендерить їх під час першого запиту, а далі віддає результат із пам'яті. Якщо перед ендпоінтами стоїть output caching, вартість одного запиту майже така сама, як у статичного файлу, а вся логіка лишається звичайним кодом C#, який можна налагоджувати, тестувати й розширювати. До того ж це компактний проєкт, що зачіпає впровадження залежностей, конвеєр запитів, кешування та конкурентність. Саме ці теми постійно з'являються на технічних співбесідах з .NET.
| Критерій | Генератор статичних сайтів | Блог на ASP.NET Core Minimal API |
|---|---|---|
| Формат контенту | Markdown + front matter | Markdown + front matter |
| Коли відбувається рендеринг | Під час збирання | Перший запит, далі кеш |
| Власна логіка | Плагіни, шаблони | Звичайні ендпоінти на C# |
| Хостинг | Будь-який статичний хостинг або CDN | Контейнер, App Service, будь-який VPS |
| Оновлення контенту | Перезбирання і повторне розгортання | Спостерігач за файлами перезавантажує сховище |
Налаштування проєкту ASP.NET Core на .NET 10
Усе починається з порожнього вебшаблону. Команда dotnet new web створює проєкт на SDK Microsoft.NET.Sdk.Web, який компілює компоненти .razor без додаткового налаштування. Решту забезпечують три пакети: Markdig для розбору CommonMark, YamlDotNet для метаданих і System.ServiceModel.Syndication для стрічки.
# terminal
dotnet new web -n CSharpBlog --framework net10.0
cd CSharpBlog
dotnet add package Markdig
dotnet add package YamlDotNet
dotnet add package System.ServiceModel.Syndication
mkdir posts Posts Endpoints ComponentsФайл Program.cs поєднує всі складники. Сховище дописів реєструється як синглтон, бо розібрані дописи спільні для всіх запитів. Проміжне ПЗ output caching стоїть у конвеєрі перед ендпоінтами, тож закешована відповідь узагалі не запускає обробник.
var builder = WebApplication.CreateBuilder(args);
// Site settings bound from the "Blog" section of appsettings.json
builder.Services.Configure<BlogOptions>(builder.Configuration.GetSection("Blog"));
builder.Services.AddSingleton<PostStore>(); // one parsed snapshot shared by all requests
builder.Services.AddRazorComponents(); // enables RazorComponentResult rendering
builder.Services.AddOpenApi(); // OpenAPI 3.1 document for the JSON API
builder.Services.AddOutputCache(options =>
options.AddBasePolicy(policy => policy.Expire(TimeSpan.FromHours(1))));
var app = builder.Build();
app.MapStaticAssets(); // CSS and images from wwwroot, fingerprinted since .NET 9
app.UseOutputCache(); // must run before the endpoints it caches
app.MapOpenApi();
app.MapBlogEndpoints();
app.MapFeedEndpoints();
app.Run();
public sealed class BlogOptions
{
public string Title { get; set; } = "C# Notes";
public string SiteUrl { get; set; } = "https://localhost:5001/";
}Налаштування SiteUrl знадобиться пізніше: канонічні адреси та посилання у стрічці формуються з конфігурації, а не із заголовка Host вхідного запиту.
Розбір дописів Markdown із front matter у C#
Кожен допис є окремим файлом, наприклад posts/output-caching-dotnet-10.md. Ім'я файлу стає слагом, а блок YAML на початку містить метадані:
---
title: Output caching in .NET 10
summary: How tag-based eviction keeps cached pages fresh.
date: 2026-11-10
tags: [aspnet-core, performance]
draft: false
---
Output caching stores the full response on the server...Парсер відокремлює блок YAML від тексту, десеріалізує метадані в невеликий клас і перетворює решту на HTML. Спочатку нормалізуються символи кінця рядка: інакше допис, збережений у Windows із \r\n, ламає пошук роздільника ---.
using Markdig;
using YamlDotNet.Serialization;
using YamlDotNet.Serialization.NamingConventions;
public sealed record Post(string Slug, string Title, string Summary,
DateTime PublishedOn, IReadOnlyList<string> Tags, bool Draft, string Html);
public static class PostParser
{
// Built once and reused by every reload
private static readonly MarkdownPipeline Pipeline =
new MarkdownPipelineBuilder().UseAdvancedExtensions().Build();
private static readonly IDeserializer Yaml = new DeserializerBuilder()
.WithNamingConvention(CamelCaseNamingConvention.Instance)
.IgnoreUnmatchedProperties() // unknown keys do not crash the reload
.Build();
public static Post Parse(string slug, string text)
{
text = text.ReplaceLineEndings("\n");
if (!text.StartsWith("---\n"))
throw new FormatException($"{slug}: missing front matter");
var end = text.IndexOf("\n---", 4, StringComparison.Ordinal);
if (end < 0)
throw new FormatException($"{slug}: unterminated front matter");
var meta = Yaml.Deserialize<FrontMatter>(text[4..end]);
var html = Markdown.ToHtml(text[(end + 4)..], Pipeline);
return new Post(slug, meta.Title, meta.Summary, meta.Date, meta.Tags, meta.Draft, html);
}
private sealed class FrontMatter
{
public string Title { get; set; } = "";
public string Summary { get; set; } = "";
public DateTime Date { get; set; }
public List<string> Tags { get; set; } = [];
public bool Draft { get; set; }
}
}Виклик UseAdvancedExtensions() вмикає таблиці, виноски, списки завдань, автоматичні ідентифікатори заголовків та інші розширення Markdig, потрібні технічному блогу. Варто пам'ятати, що Markdig за замовчуванням пропускає сирий HTML. Для дописів, які пише власник сайту, це прийнятно, але будь-який Markdown від користувачів (коментарі, гостьові дописи) потребує DisableHtml() у своєму конвеєрі, щоб уникнути stored XSS.
Статичні поля Pipeline і Yaml також обрано свідомо. Створення конвеєра Markdig і десеріалізатора YamlDotNet коштує ресурсів, а обидва об'єкти безпечно спільно використовувати між потоками, тому їх достатньо створити один раз на весь час роботи процесу.
Потокобезпечне сховище-синглтон із гарячим перезавантаженням
Під час запуску сховище читає всі файли й тримає результат у FrozenDictionary (доступний з .NET 8), колекції, оптимізованій для інтенсивного читання. Коли файл змінюється, сховище з нуля будує новий словник і підміняє посилання одним присвоєнням. Читачі ніколи не беруть блокування: кожен запит бачить або старий знімок, або новий, але ніколи не напівзібрану колекцію.
using System.Collections.Frozen;
using Microsoft.AspNetCore.OutputCaching;
using Microsoft.Extensions.FileProviders;
using Microsoft.Extensions.Primitives;
public sealed class PostStore
{
private readonly PhysicalFileProvider _files;
private readonly IOutputCacheStore _cache;
private readonly ILogger<PostStore> _logger;
private volatile FrozenDictionary<string, Post> _bySlug = FrozenDictionary<string, Post>.Empty;
public PostStore(IWebHostEnvironment env, IOutputCacheStore cache, ILogger<PostStore> logger)
{
(_cache, _logger) = (cache, logger);
_files = new PhysicalFileProvider(Path.Combine(env.ContentRootPath, "posts"));
Reload();
ChangeToken.OnChange(() => _files.Watch("*.md"), Reload); // re-registers after each change
}
public Post? Find(string slug) => _bySlug.TryGetValue(slug, out var post) ? post : null;
public IReadOnlyList<Post> Latest(int count) =>
_bySlug.Values.OrderByDescending(p => p.PublishedOn).Take(count).ToList();
private void Reload()
{
try
{
var snapshot = _files.GetDirectoryContents("")
.Where(f => !f.IsDirectory && f.Name.EndsWith(".md", StringComparison.Ordinal))
.Select(f => PostParser.Parse(Path.GetFileNameWithoutExtension(f.Name), File.ReadAllText(f.PhysicalPath!)))
.Where(p => !p.Draft)
.ToFrozenDictionary(p => p.Slug);
_bySlug = snapshot; // atomic reference swap
_ = _cache.EvictByTagAsync("posts", CancellationToken.None).AsTask();
_logger.LogInformation("Loaded {Count} posts", snapshot.Count);
}
catch (Exception ex)
{
_logger.LogError(ex, "Reload failed, keeping the previous snapshot"); // a typo never takes the site down
}
}
}Готовим до продакшну цей код роблять три деталі:
- Поле з модифікатором
volatileгарантує, що інші потоки прочитають актуальне посилання після підміни. - Блок
try/catchзберігає останній коректний знімок, якщо в якомусь дописі зламаний YAML. Помилка в одному файлі не спустошує весь блог. - Виклик
EvictByTagAsyncвидаляє з кешу всі сторінки з тегомposts, тож новий контент з'являється вже на наступному запиті, а не після закінчення години базової політики.
Окремо варто згадати ChangeToken.OnChange. Токен змін, який повертає PhysicalFileProvider, одноразовий: після першого спрацювання він більше не сповіщає. OnChange приймає фабрику токенів і після кожної зміни заново реєструє спостереження, тож розробнику не доводиться вручну керувати підпискою.
FileSystemWatcher покладається на сповіщення операційної системи, які ненадійно проходять крізь bind mount у Docker і мережеві ресурси. У контейнері, куди змонтовано теку posts, слід встановити змінну середовища DOTNET_USE_POLLING_FILE_WATCHER=true або PhysicalFileProvider.UsePollingFileWatcher = true. Редактори також зберігають файли кількома записами, тому Reload може спрацювати двічі чи тричі на одне збереження. Тут це нешкідливо, адже кожен запуск дає той самий знімок.
Ендпоінти Minimal API з групами маршрутів і TypedResults
Публічні сторінки згруповано під /blog за допомогою MapGroup, що дає змогу в одному місці застосувати політику output cache та її тег до всіх ендпоінтів. Обробники повертають RazorComponentResult<T> (доступний з .NET 8), який рендерить компонент Razor як повну HTTP-відповідь без MVC, Razor Pages і маршрутизатора Blazor.
using CSharpBlog.Components; // namespace of PostPage and PostListPage
using Microsoft.AspNetCore.Http.HttpResults;
public static class BlogEndpoints
{
public static IEndpointRouteBuilder MapBlogEndpoints(this IEndpointRouteBuilder app)
{
var blog = app.MapGroup("/blog").CacheOutput(p => p.Tag("posts"));
blog.MapGet("/", (PostStore store) =>
new RazorComponentResult<PostListPage>(new { Posts = store.Latest(20) }));
blog.MapGet("/{slug:regex(^[a-z0-9-]+$)}", GetPost); // rejects odd slugs before the handler
app.MapGet("/api/posts", (PostStore store) =>
TypedResults.Ok(store.Latest(50).Select(p => new PostSummary(p.Slug, p.Title, p.Summary, p.PublishedOn))))
.CacheOutput(p => p.Tag("posts"))
.WithName("ListPosts");
return app;
}
// The union return type documents both outcomes for OpenAPI and for unit tests
private static Results<RazorComponentResult<PostPage>, NotFound> GetPost(string slug, PostStore store) =>
store.Find(slug) is { } post
? new RazorComponentResult<PostPage>(new { Post = post })
: TypedResults.NotFound();
}
public sealed record PostSummary(string Slug, string Title, string Summary, DateTime PublishedOn);Тип повернення Results<T1, T2> якраз і відрізняє TypedResults від старіших помічників Results. Компілятор перевіряє, що обробник повертає лише оголошені результати, генератор OpenAPI зчитує обидва коди стану безпосередньо із сигнатури, а модульний тест може перевірити result.Result is NotFound без запуску сервера. JSON-ендпоінт винесено за межі групи /blog, щоб його адреса не конфліктувала зі слагами дописів.
Обмеження regex(^[a-z0-9-]+$) у шаблоні маршруту відсіює нетипові слаги ще до обробника. Запити з крапками, скісними рисками чи великими літерами отримують 404 вже на етапі маршрутизації.
Сторінка допису є звичайним компонентом Razor. MarkupString вказує Razor виводити результат Markdig як HTML без екранування, а канонічна адреса береться з BlogOptions.
@* Components/PostPage.razor *@
@using Microsoft.Extensions.Options
@inject IOptions<BlogOptions> Options
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="utf-8" />
<title>@Post.Title | @Options.Value.Title</title>
<meta name="description" content="@Post.Summary" />
<link rel="canonical" href="@(new Uri(new Uri(Options.Value.SiteUrl), $"blog/{Post.Slug}"))" />
<link rel="alternate" type="application/rss+xml" title="@Options.Value.Title" href="/feed.xml" />
<link rel="stylesheet" href="/site.css" />
</head>
<body>
<article>
<h1>@Post.Title</h1>
<time datetime="@(Post.PublishedOn.ToString("yyyy-MM-dd"))">@(Post.PublishedOn.ToString("d MMMM yyyy"))</time>
@((MarkupString)Post.Html)
</article>
</body>
</html>
@code {
[Parameter, EditorRequired] public Post Post { get; set; } = default!;
}PostListPage.razor побудовано за тим самим принципом: компонент приймає параметр Posts і в циклі виводить заголовки та анотації. Анонімний об'єкт, переданий у RazorComponentResult, зіставляє назви своїх властивостей із параметрами компонента, тому new { Post = post } має точно відповідати параметру Post. Помилку в назві компілятор не помітить, вона проявиться лише під час виконання.
Готовий до співбесід з .NET?
Практикуйся з нашими інтерактивними симуляторами, flashcards та технічними тестами.
Output caching для сторінок блогу на ASP.NET Core
Output caching, що з'явився в ASP.NET Core 7, зберігає всю відповідь на сервері й відтворює її без запуску обробника та повторного рендерингу компонента. Це інший механізм, ніж старіше проміжне ПЗ response caching, яке дотримується семантики HTTP-заголовка Cache-Control і дозволяє клієнту оминути кеш заголовком no-cache. Документація з output caching на Microsoft Learn описує правила за замовчуванням: кешуються лише запити GET і HEAD з кодом 200, а відповіді, що встановлюють cookie або стосуються автентифікованих запитів, пропускаються.
Саме теги роблять output caching придатним для контентного сайту. Кожен ендпоінт блогу має тег posts, а сховище інвалідує цей тег після кожного перезавантаження. Годинна базова політика лише страхує: на практиці сторінки лишаються в кеші, доки не зміниться контент.
У розгортанні з кількома екземплярами сховище в пам'яті належить окремому процесу: інвалідація на одному екземплярі залишає застарілі сторінки на інших. ASP.NET Core пропонує сховище на базі Redis через пакет Microsoft.AspNetCore.OutputCaching.StackExchangeRedis і метод AddStackExchangeRedisOutputCache, яке поширює записи кешу та інвалідацію між екземплярами. Для одного невеликого екземпляра воно не потрібне.
RSS-стрічка на C# із SyndicationFeed
Технічні читачі й досі підписуються через RSS-читачі, а агрегатори знаходять нові дописи саме у стрічці, а не в мапі сайту. SyndicationFeed разом із Rss20FeedFormatter формують стрічку відповідно до специфікації RSS 2.0 без ручного написання XML.
using System.ServiceModel.Syndication;
using System.Text;
using System.Xml;
using Microsoft.Extensions.Options;
public static class FeedEndpoints
{
public static IEndpointRouteBuilder MapFeedEndpoints(this IEndpointRouteBuilder app)
{
app.MapGet("/feed.xml", (PostStore store, IOptions<BlogOptions> options) =>
{
var site = new Uri(options.Value.SiteUrl); // never built from the Host header
var items = store.Latest(20).Select(p =>
{
var date = new DateTimeOffset(DateTime.SpecifyKind(p.PublishedOn, DateTimeKind.Utc));
return new SyndicationItem(p.Title, p.Summary, new Uri(site, $"blog/{p.Slug}"), p.Slug, date)
{
PublishDate = date // RSS pubDate comes from PublishDate, not LastUpdatedTime
};
});
var feed = new SyndicationFeed(options.Value.Title, "Articles on C# and .NET", site, items);
using var buffer = new MemoryStream();
using (var writer = XmlWriter.Create(buffer, new XmlWriterSettings { Encoding = new UTF8Encoding(false) }))
new Rss20FeedFormatter(feed).WriteTo(writer); // writer flushes on dispose
return TypedResults.Bytes(buffer.ToArray(), "application/rss+xml; charset=utf-8");
}).CacheOutput(p => p.Tag("posts"));
return app;
}
}Побудова абсолютних адрес із BlogOptions.SiteUrl замість HttpContext.Request.Host закриває вразливість host header injection. Без цього один запит із підробленим заголовком Host потрапив би в кеш, і кожен підписник отримував би посилання на чужий домен. Аргумент UTF8Encoding(false) прибирає маркер BOM, який деякі RSS-читачі відхиляють. Також важливе присвоєння PublishDate: елемент pubDate у RSS береться саме з цієї властивості, а не з LastUpdatedTime, переданого в конструктор.
Розгортання технічного блогу на C# і обмеження Native AOT
Команда dotnet publish -c Release створює збірку, залежну від фреймворку, яка запускається на будь-якому хості з runtime .NET 10. Починаючи з .NET 8, SDK також уміє збирати образи контейнерів без Dockerfile: dotnet publish -c Release /t:PublishContainer створює образ на основі офіційного образу runtime ASP.NET Core. Теку posts можна вбудувати в образ (тоді кожна зміна контенту вимагає повторного розгортання) або змонтувати як том (тоді зміни підхоплює спостерігач за файлами).
Native AOT приваблює швидшим запуском і меншим споживанням пам'яті, проте цей проєкт для нього не найкращий кандидат. Таблиця сумісності Native AOT в ASP.NET Core позначає Minimal APIs як частково підтримувані, а Blazor Server як непідтримуваний, до того ж десеріалізатор YamlDotNet за замовчуванням покладається на рефлексію. Блог віддає закешовані сторінки з процесу, що працює довго, тож час запуску майже нічого не важить. Перехід на AOT означав би заміну компонентів Razor текстовими шаблонами, а YAML на JSON front matter із генератором коду, і все це заради незначного виграшу.
Питання зі співбесід з .NET, до яких готує цей проєкт
Кожна частина рушія відповідає питанню, яке звучить на співбесідах з ASP.NET Core. Питання зі співбесід з .NET на SharpSkill розглядають їх детально, а модуль про Minimal APIs зосереджений на рівні ендпоінтів.
«Чи безпечний сервіс-синглтон, якщо його одночасно читає багато запитів?» Лише тоді, коли його стан незмінний або синхронізований. Описане сховище використовує незмінний знімок і підміну посилання volatile, тож читачі не блокуються, а запис не блокує читання. Класична пастка: синглтон із List<T>, яку змінюють під час перезавантаження, під навантаженням кидає InvalidOperationException посеред перебору. Модуль про впровадження залежностей також розбирає проблему captive dependency: синглтон, що отримує сервіс з областю scoped, наприклад DbContext, утримує його живим протягом усього життя застосунку.
«Чим output caching відрізняється від response caching?» Output caching контролює сервер, він підтримує теги й інвалідацію та ігнорує заголовки кешування від клієнта. Response caching дотримується семантики HTTP і є здебільшого підказкою для проксі та браузерів.
«Навіщо повертати TypedResults замість Results?» Конкретні типи результатів дають перевірку можливих відповідей під час компіляції, автоматичні метадані OpenAPI та обробники, які тестуються як звичайні методи. Глибше порівняння з контролерами є у статті про архітектуру й продуктивність Minimal APIs.
«Де в цьому застосунку важливий порядок проміжного ПЗ?» UseOutputCache має бути зареєстрований перед ендпоінтами, які він кешує, і після UseCors, якщо CORS увімкнено. Кандидат, який також може пояснити, чому політика за замовчуванням ніколи не кешує автентифіковані запити і що має перевірити власна реалізація IOutputCachePolicy, перш ніж їх кешувати, демонструє розуміння конвеєра, а не завчений порядок.
Блог на C# з ASP.NET Core: головні висновки
- Проєкт стартує з
dotnet new webна .NET 10 і потребує лише Markdig, YamlDotNet таSystem.ServiceModel.Syndication. Технічному блогу не потрібні ні CMS, ні база даних. - Дописи розбираються один раз у незмінний
FrozenDictionary, а під час перезавантаження підміняється весь знімок: читання обходиться без блокувань, а зламаний файл не спустошує сайт. - HTML рендериться через
RazorComponentResult<T>з обробників Minimal API, а типи поверненняResults<T1, T2>дають OpenAPI і модульним тестам бачити кожен можливий результат. - Усі контентні ендпоінти працюють за output caching зі спільним тегом, а
EvictByTagAsyncпісля кожного перезавантаження замінює короткі терміни дії кешу. - Канонічні адреси й посилання у стрічці формуються з конфігурації, ніколи із заголовка
Host. Кожен конвеєр, що рендерить Markdown від користувачів, потребуєDisableHtml(). - Якщо теку з дописами змонтовано в контейнер, потрібна змінна
DOTNET_USE_POLLING_FILE_WATCHER=true. - Проєкт добре підходить для підготовки до співбесіди: варто вміти вголос пояснити потокобезпечність синглтона, вибір механізму кешування та порядок проміжного ПЗ.
Починай практикувати!
Перевір свої знання з нашими симуляторами співбесід та технічними тестами.
Чи знайдеш ти помилку в .NET?
Справжній фрагмент коду, прихована помилка, одна спроба на день. Щоб спробувати, акаунт не потрібен.

Автор:
Anthony Fillion-MailletЗасновник SharpSkill
Fullstack-розробник понад 10 років. Керує SharpSkill і відповідає за все, що тут публікується.
Оновлено 17 листопада 2026 р.
Теги
Поділитися
Пов'язані статті

Час життя DbContext в ASP.NET Core: Продуктивність проти потокобезпечності в асинхронних операціях
Опануйте керування часом життя DbContext в ASP.NET Core. Дізнайтеся, коли використовувати scoped проти transient, як безпечно обробляти асинхронні операції та оптимізувати продуктивність за допомогою пулінгу DbContext.

.NET 9 Blazor: Full-Stack розробка з Blazor United у 2026 році
.NET 9 Blazor United об'єднує статичний SSR, Server та WebAssembly режими рендерингу в єдиний full-stack фреймворк. Практичний посібник з режимами рендерингу, streaming rendering, dependency injection та production-ready патернами.

Clean Architecture з .NET: практичний посібник
Опанування Clean Architecture у .NET з C#. Знайомство з принципами SOLID, поділом на шари та шаблонами реалізації для зручних в підтримці застосунків.