# Блог на C# у 2026 році: технічний блог на ASP.NET Core та Minimal APIs > Покроковий посібник зі створення блогу на C# і .NET 10: дописи в Markdown із front matter, потокобезпечне сховище з гарячим перезавантаженням, сторінки з компонентів Razor, output caching і RSS-стрічка. - Published: 2026-11-17 - Updated: 2026-11-17 - Author: Anthony Fillion-Maillet - Tags: dotnet, csharp, aspnet-core, minimal-apis, output-caching, tutorial - Reading time: 13 min --- Технічний блог на 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](https://github.com/xoofx/markdig) для розбору CommonMark, YamlDotNet для метаданих і `System.ServiceModel.Syndication` для стрічки. ```bash # 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 стоїть у конвеєрі перед ендпоінтами, тож закешована відповідь узагалі не запускає обробник. ```csharp // Program.cs var builder = WebApplication.CreateBuilder(args); // Site settings bound from the "Blog" section of appsettings.json builder.Services.Configure(builder.Configuration.GetSection("Blog")); builder.Services.AddSingleton(); // 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 на початку містить метадані: ```markdown --- 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`, ламає пошук роздільника `---`. ```csharp // Posts/PostParser.cs using Markdig; using YamlDotNet.Serialization; using YamlDotNet.Serialization.NamingConventions; public sealed record Post(string Slug, string Title, string Summary, DateTime PublishedOn, IReadOnlyList 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(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 Tags { get; set; } = []; public bool Draft { get; set; } } } ``` Виклик `UseAdvancedExtensions()` вмикає таблиці, виноски, списки завдань, автоматичні ідентифікатори заголовків та інші розширення Markdig, потрібні технічному блогу. Варто пам'ятати, що Markdig за замовчуванням пропускає сирий HTML. Для дописів, які пише власник сайту, це прийнятно, але будь-який Markdown від користувачів (коментарі, гостьові дописи) потребує `DisableHtml()` у своєму конвеєрі, щоб уникнути stored XSS. Статичні поля `Pipeline` і `Yaml` також обрано свідомо. Створення конвеєра Markdig і десеріалізатора YamlDotNet коштує ресурсів, а обидва об'єкти безпечно спільно використовувати між потоками, тому їх достатньо створити один раз на весь час роботи процесу. ## Потокобезпечне сховище-синглтон із гарячим перезавантаженням Під час запуску сховище читає всі файли й тримає результат у `FrozenDictionary` (доступний з .NET 8), колекції, оптимізованій для інтенсивного читання. Коли файл змінюється, сховище з нуля будує новий словник і підміняє посилання одним присвоєнням. Читачі ніколи не беруть блокування: кожен запит бачить або старий знімок, або новий, але ніколи не напівзібрану колекцію. ```csharp // Posts/PostStore.cs 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 _logger; private volatile FrozenDictionary _bySlug = FrozenDictionary.Empty; public PostStore(IWebHostEnvironment env, IOutputCacheStore cache, ILogger 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 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` (доступний з .NET 8), який рендерить компонент Razor як повну HTTP-відповідь без MVC, Razor Pages і маршрутизатора Blazor. ```csharp // Endpoints/BlogEndpoints.cs 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(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, NotFound> GetPost(string slug, PostStore store) => store.Find(slug) is { } post ? new RazorComponentResult(new { Post = post }) : TypedResults.NotFound(); } public sealed record PostSummary(string Slug, string Title, string Summary, DateTime PublishedOn); ``` Тип повернення `Results` якраз і відрізняє `TypedResults` від старіших помічників `Results`. Компілятор перевіряє, що обробник повертає лише оголошені результати, генератор OpenAPI зчитує обидва коди стану безпосередньо із сигнатури, а модульний тест може перевірити `result.Result is NotFound` без запуску сервера. JSON-ендпоінт винесено за межі групи `/blog`, щоб його адреса не конфліктувала зі слагами дописів. Обмеження `regex(^[a-z0-9-]+$)` у шаблоні маршруту відсіює нетипові слаги ще до обробника. Запити з крапками, скісними рисками чи великими літерами отримують 404 вже на етапі маршрутизації. Сторінка допису є звичайним компонентом Razor. `MarkupString` вказує Razor виводити результат Markdig як HTML без екранування, а канонічна адреса береться з `BlogOptions`. ```razor @* Components/PostPage.razor *@ @using Microsoft.Extensions.Options @inject IOptions Options @Post.Title | @Options.Value.Title

@Post.Title

@((MarkupString)Post.Html)
@code { [Parameter, EditorRequired] public Post Post { get; set; } = default!; } ``` `PostListPage.razor` побудовано за тим самим принципом: компонент приймає параметр `Posts` і в циклі виводить заголовки та анотації. Анонімний об'єкт, переданий у `RazorComponentResult`, зіставляє назви своїх властивостей із параметрами компонента, тому `new { Post = post }` має точно відповідати параметру `Post`. Помилку в назві компілятор не помітить, вона проявиться лише під час виконання. ## Output caching для сторінок блогу на ASP.NET Core Output caching, що з'явився в ASP.NET Core 7, зберігає всю відповідь на сервері й відтворює її без запуску обробника та повторного рендерингу компонента. Це інший механізм, ніж старіше проміжне ПЗ response caching, яке дотримується семантики HTTP-заголовка `Cache-Control` і дозволяє клієнту оминути кеш заголовком `no-cache`. [Документація з output caching на Microsoft Learn](https://learn.microsoft.com/en-us/aspnet/core/performance/caching/output) описує правила за замовчуванням: кешуються лише запити `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](https://www.rssboard.org/rss-specification) без ручного написання XML. ```csharp // Endpoints/FeedEndpoints.cs 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 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](https://learn.microsoft.com/en-us/aspnet/core/fundamentals/native-aot) позначає Minimal APIs як частково підтримувані, а Blazor Server як непідтримуваний, до того ж десеріалізатор YamlDotNet за замовчуванням покладається на рефлексію. Блог віддає закешовані сторінки з процесу, що працює довго, тож час запуску майже нічого не важить. Перехід на AOT означав би заміну компонентів Razor текстовими шаблонами, а YAML на JSON front matter із генератором коду, і все це заради незначного виграшу. ## Питання зі співбесід з .NET, до яких готує цей проєкт Кожна частина рушія відповідає питанню, яке звучить на співбесідах з ASP.NET Core. [Питання зі співбесід з .NET на SharpSkill](https://sharpskill.dev/uk/technologies/dotnet) розглядають їх детально, а [модуль про Minimal APIs](https://sharpskill.dev/uk/technologies/dotnet/pytannia-spivbesidy/minimal-apis) зосереджений на рівні ендпоінтів. **«Чи безпечний сервіс-синглтон, якщо його одночасно читає багато запитів?»** Лише тоді, коли його стан незмінний або синхронізований. Описане сховище використовує незмінний знімок і підміну посилання `volatile`, тож читачі не блокуються, а запис не блокує читання. Класична пастка: синглтон із `List`, яку змінюють під час перезавантаження, під навантаженням кидає `InvalidOperationException` посеред перебору. [Модуль про впровадження залежностей](https://sharpskill.dev/uk/technologies/dotnet/pytannia-spivbesidy/dependency-injection) також розбирає проблему captive dependency: синглтон, що отримує сервіс з областю scoped, наприклад `DbContext`, утримує його живим протягом усього життя застосунку. **«Чим output caching відрізняється від response caching?»** Output caching контролює сервер, він підтримує теги й інвалідацію та ігнорує заголовки кешування від клієнта. Response caching дотримується семантики HTTP і є здебільшого підказкою для проксі та браузерів. **«Навіщо повертати `TypedResults` замість `Results`?»** Конкретні типи результатів дають перевірку можливих відповідей під час компіляції, автоматичні метадані OpenAPI та обробники, які тестуються як звичайні методи. Глибше порівняння з контролерами є у статті про [архітектуру й продуктивність Minimal APIs](https://sharpskill.dev/uk/blog/dotnet/aspnet-core-minimal-apis-architecture-performance-interview). **«Де в цьому застосунку важливий порядок проміжного ПЗ?»** `UseOutputCache` має бути зареєстрований перед ендпоінтами, які він кешує, і після `UseCors`, якщо CORS увімкнено. Кандидат, який також може пояснити, чому політика за замовчуванням ніколи не кешує автентифіковані запити і що має перевірити власна реалізація `IOutputCachePolicy`, перш ніж їх кешувати, демонструє розуміння конвеєра, а не завчений порядок. ## Блог на C# з ASP.NET Core: головні висновки - Проєкт стартує з `dotnet new web` на .NET 10 і потребує лише Markdig, YamlDotNet та `System.ServiceModel.Syndication`. Технічному блогу не потрібні ні CMS, ні база даних. - Дописи розбираються один раз у незмінний `FrozenDictionary`, а під час перезавантаження підміняється весь знімок: читання обходиться без блокувань, а зламаний файл не спустошує сайт. - HTML рендериться через `RazorComponentResult` з обробників Minimal API, а типи повернення `Results` дають OpenAPI і модульним тестам бачити кожен можливий результат. - Усі контентні ендпоінти працюють за output caching зі спільним тегом, а `EvictByTagAsync` після кожного перезавантаження замінює короткі терміни дії кешу. - Канонічні адреси й посилання у стрічці формуються з конфігурації, ніколи із заголовка `Host`. Кожен конвеєр, що рендерить Markdown від користувачів, потребує `DisableHtml()`. - Якщо теку з дописами змонтовано в контейнер, потрібна змінна `DOTNET_USE_POLLING_FILE_WATCHER=true`. - Проєкт добре підходить для підготовки до співбесіди: варто вміти вголос пояснити потокобезпечність синглтона, вибір механізму кешування та порядок проміжного ПЗ. --- Source: SharpSkill (https://sharpskill.dev), tech interview preparation for your real stack. HTML version of this page: https://sharpskill.dev/uk/blog/dotnet/csharp-blog-aspnet-core-minimal-apis-2026