This is a viewer only at the moment see the article on how this works.
To update the preview hit Ctrl-Alt-R (or ⌘-Alt-R on Mac) or Enter to refresh. The Save icon lets you save the markdown file to disk
This is a preview from the server running through my markdig pipeline
найяскравіший.MinimalBlog - Як просто може бути ASPM SK2NET блог
Monday, 01 December 2025
Введение
Якщо ви ' читали цей блог , ви могли помітити, що моя основна блогова платформа - це МSK2 дозвольте \ ' називати її \ МSK4\ захопливо розроблена ."\ PostgreSQL та векторні бази даних \МSK6\ семантичні та повні \ мSK7\ пошук тексту з індексами GIN \ ,\ автоматичний переклад на \ एमСК9\ мови | МСК10 \ численні хостеві послуги | , \ Планування роботи Hangfire \ msк12 \ Prometheus метрики \ มСК13 \ Serilog відслідковування \мСК14 \ HTMX інтерактиви \ ми підпорядковуємо власні пакети нугета \мск16 \ і достатньо контейнерів Docker для того, щоб зробити корабель завидливим \
Це повністю навмисно. Це моя лабораторія, де я експериментую з технологіями. нібито щоб бути над "-", тому що МSK1 - це те, як я вчуся МСК2 , розв 'язуючи проблеми, яких більшість блогів не мають СМСК3 . Взагалі-то MSК4 , а тоді пакувати ці рішення як відкриті .
Але ось в чому справа. ви, мабуть, не потребуєте нічого з цього, щоб вести блог
Ось чому я створив найяскравіший.MinimalBlog -, щоб показати, що відбувається, коли ви відкидаєте всі експерименти і зосереджуєтесь на абсолютних невід 'ємних речах . Немає бази даних МSK2 Немають конвеєрів для будування M SK3 Немаєте складності . Просто помічаєте файли у папці MSC5 з' являються в інтернеті MST6 Ось як виглядає блог, якщо ви не використовуєте його як лабораторію
NOTA: Подивіться на кінець статті, щоб побачити зв 'язок з джерелом пакет нугета як тільки я отримую час, щоб переконатися в тому, що МСК0 МСК1 надійний і що МSK2 не жахливий '
Філософія: Менше - це більше .
Весь проект розроблений за принципом МСК0 . тримай це просто. Немає бази даних , немає конвеєра збудування МSK2 немає фреймворка JavaScript M SK3 лише ASP MSC4 NET 9.0, Маркідж для відмітки для розшифровування
NOTE: Ви можете навіть зробити це з боку клієнта, використовуючи знизити а потім просто мати статичну карту сервера .md файлів і зробити його навіть SIMPLER, але ... добре це ASP . NET блог
Структура проекту
Давайте поглянемо на те, як проект організований.
Mostlylucid.MinimalBlog/
├── Pages/
│ ├── Index.cshtml # Homepage with post list
│ ├── Post.cshtml # Individual post page
│ ├── Categories.cshtml # List of all categories
│ ├── Category.cshtml # Posts in a category
│ ├── _Layout.cshtml # Shared layout
│ ├── _ViewImports.cshtml # Shared imports
│ └── _ViewStart.cshtml # Layout selection
├── wwwroot/
│ └── css/
│ └── site.css # All the CSS you need
├── MarkdownBlogService.cs # Core blog logic
├── MetaWeblogService.cs # XML-RPC for external editors
├── Program.cs # Application setup
├── appsettings.json # Configuration
└── Mostlylucid.MinimalBlog.csproj # Project file
Серце: MarkdownBlogService
Ядро блогу - це MarkdownBlogService клас. ЦеM SK1 надзвичайно простий- тільки MSC3 рядки коду, які обробляютьМSK4
- Читання файлів відмітки з каталогу
- Розшифровування метадань (головокМSK1 категоріїM SK2 дата публікації)
- Перетворення позначки в HTML за допомогою Markdig
- Caching everything in memory
Ось як це працює.
Завантаження постів
Служба сканує задану папку для .md і завантажує їх в пам 'ять:
private List<BlogPost> LoadAllPosts()
{
if (!Directory.Exists(_markdownPath)) return [];
return Directory.GetFiles(_markdownPath, "*.md", SearchOption.TopDirectoryOnly)
.Where(f => Path.GetFileName(f).Count(c => c == '.') == 1) // Only base .md files
.Select(ParseFile)
.Where(p => p is { IsHidden: false })
.OrderByDescending(p => p!.PublishedDate)
.ToList()!;
}
Зверніть увагу на розумне фільтрування: Count(c => c == '.') == 1 гарантує, що ми отримаємо тільки базу .md файли, не перекладені так, як post.ar.md або post.de.md ( якщо ви хочете додати переклади пізнішеM SK1
Розшифровування метадань
Кожен файл відмітки має просту концепцію:
# Post Title
Your content here...
Розшифровувач виділяє ці метадані за допомогою звичайного вираження та Маркдіга AST:
private BlogPost? ParseFile(string filePath)
{
var markdown = File.ReadAllText(filePath);
var slug = Path.GetFileNameWithoutExtension(filePath);
var document = Markdown.Parse(markdown, _pipeline);
// Extract title from first H1
var title = document.Descendants<HeadingBlock>()
.FirstOrDefault(h => h.Level == 1)?
.Inline?.FirstChild?.ToString() ?? slug;
// Extract categories:
var categoryMatch = CategoryRegex().Match(markdown);
var categories = categoryMatch.Success
? categoryMatch.Groups[1].Value.Split(',', StringSplitOptions.TrimEntries)
: [];
// Extract date:
var dateMatch = DateTimeRegex().Match(markdown);
var publishedDate = dateMatch.Success && DateTime.TryParse(dateMatch.Groups[1].Value, out var dt)
? dt : File.GetCreationTimeUtc(filePath);
return new BlogPost
{
Slug = slug,
Title = title,
Categories = categories,
PublishedDate = publishedDate,
HtmlContent = Markdown.ToHtml(markdown, _pipeline),
IsHidden = markdown.Contains("<hidden")
};
}
Стратегія Caching
Кожна методика в службі використовує IMemoryCache щоб уникнути перечитування та аналізу файлів на кожному запиті
public IReadOnlyList<BlogPost> GetAllPosts()
{
return cache.GetOrCreate("all_posts", entry =>
{
entry.SetOptions(CacheOptions);
return LoadAllPosts();
}) ?? [];
}
Вхіди в кэш мають тривалість 30- Minuтного вичерпування і МSK1 Абсолютне вичерпання на годину МSK2 Прості , ефективні
Установлення додатку: ПрограмуM SK1cs
Це всього лиш 43 рядки : Розібрані сторінки МSK2 пам 'ять, кэш, , вихідний кэш
UI: Прості розібрані сторінки
У інтерфейсі є чистий сервер-рендерований HTML. Без JavaskripM SK2 без HTMX , без альпіанськогоMスク4jsMSC5 Домашня сторінка впорядковує постиМSK6 пост-сторінка рендерує @Html.Raw(post.HtmlContent) з [OutputCache] атрибут на годину- довгий HTML CachingM SK1 Чотири сторінки вкупі , кожен з них під 30 рядки МSK4
Сタイリング: M SK1 Ліни CSS
Весь візуальний дизайн оброблений одним CSS-файлом з лише 55 рядками . Він використовує налаштування CSS для малювання і створює чистийMSC2 темний GitHub- надихнутий виглядM SK4
:root {
--bg: #0d1117;
--bg-card: #161b22;
--text: #c9d1d9;
--text-muted: #8b949e;
--accent: #58a6ff;
--border: #30363d;
}
body {
font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;
background: var(--bg);
color: var(--text);
line-height: 1.6;
max-width: 48rem;
margin: 0 auto;
padding: 2rem 1rem;
}
/* ... more styles ... */
Жодного пристроювача. Жодної збудови кроку . Жодних тисяч класів корисних речей
Бонусна функція: MetaWeblog API
Для письменників, які віддають перевагу Монстр Маркдау, проект включає в себе повну implementaцію API MetaWeblog
- Список постів
- Створити нові записи
- редагувати наявні місця
- Постери
- завантажити зображення
- Згадайте категорії
Втілення MetaWeblogService.cs і обробляє повний XML-RPC протокол, аналіз запитів та генерує відповідіM SK2 Це означає, що ви можете написати ваші блогові статті в улюбленому редакторі і опублікувати їх безпосередньо на вашому блогуMSC3
Konfiguracja
Весь файл конфігурації - просто 14 рядкиM SK1
{
"MarkdownPath": "../Mostlylucid/Markdown",
"ImagesPath": "wwwroot/images",
"MetaWeblog": {
"Username": "admin",
"Password": "changeme",
"BlogUrl": "http://localhost:5000"
},
"Logging": {
"LogLevel": {
"Default": "Information"
}
}
}
MarkdownPath- де знаходяться ваші файли відміткиImagesPath- де зберігаються зображенняMetaWeblog- права на доступ до зовнішнього редактора
Використовування як пакет NuGet
Як вже згадано, він незабаром стане доступним, але ще не :)
Тепер блог доступний як NuGet пакет, що робить його банальним додавати до будь-якої ASP.NET Core aplikacjiM SK2
dotnet add package mostlylucid.MinimalBlog
Тоді у вашому Program.cs:
builder.Services.AddRazorPages();
builder.Services.AddMinimalBlog(options =>
{
options.MarkdownPath = "Markdown";
options.ImagesPath = "wwwroot/images";
options.EnableMetaWeblog = false; // Optional, defaults to true
});
var app = builder.Build();
app.UseStaticFiles();
app.UseMinimalBlog();
app.MapRazorPages();
app.Run();
Це МСК0 , це "-", лише два методи:AddMinimalBlog і UseMinimalBlog) і у вас є робочий блог
Працюючи з проектом зразка
Для запуску включного зразка проекту:
cd Mostlylucid.MinimalBlog
dotnet run
Виход http://localhost:5000 і ви побачите блог з файлами відмітки з настроїного маршруту.
Створюємо контент
Для створення нового блогу:
- Створити новий
.mdфайл у вашому настроенніMarkdownPath - Додайте стандартні метадані:
# Your Post Title Your content here... - За save the file
- Cache закінчиться впродовж 30 хвилин ( або перезапуск aplikacjiM SK2
Щоб додати зображення,, просто встановіть їх у вашому настроенні ImagesPath katalogу і віднести їх до вашої позначки.

Що не вистачає
Цей мінімальний блог навмисно не включає в себе
- Комментари - Якщо потрібно, используйте третю службу МSK1
- Поиск - Тримай свій контент впорядкований категоріями
- Метки - Категорії достатньо для маленьких блогів
- RSS/Atom - Просто додавати, якщо вам це потрібно
- Аuthentication - API MetaWeblog використовує лише базовий аут
- Аналітика - Dodaj фрагмент JavaScript, якщо хочете
- Оптимізація SEO - працює добре з базовими мета-тегими
- Відповідливі зображення - Веб-браузер керує нею
- Темна тема - Одна тема - достатньо
Ці характеристики можливо додавати, але вониM SK1 не включені по замовчуванню, тому що більшість маленьких блогів не мають їх
Характеристики ефективності
Незважаючи на свою простоту, цей блог швидко:
- Камера пам 'яті означає, що після першого завантаження не буде ніякого файлу I/O
- Виведення в кэш означає, що після першого запиту не буде рендерування Razor
- Немає бази даних означає, що немає надрахунку
- Без Javaskrip означає швидше завантаження сторінки
- Прості CSS означає мінімальне розшифровування таблиць стилю
Для малого чи середнього блогу (на основі МSK1 постів МSK2 ця архітектура перевершить більшість баз даних - закріплених блогових платформ
Коли використовувати це проти. у повному Mostlylucid Blog
Використовувати Найяскравіший.MinimalBlog коли:
- You'you are starting a personal blog
- У вас менше ніж 500 постів
- Вам не потрібні багато мов
- Ви хочете, щоб все було просто
- Ви - МСК0 - задоволені файлами відмітки
- Ви просто хочете написати і опублікувати
Використовуйте pełna платформа Mostlylucid коли:
- Ви' використовуєте свій блог як навчальна лабораторія для нових технологій
- Ви хочете експериментувати з стратегіями застосування, моніторієюM SK1 та оптимізацією продуктивності
- Ви потребуєте конкретних властивостей, таких як багатомовна підтримка, повний- пошук текстуM SK2 або коментарі
- Ви – МСК0 – створюєте пакети і потребуєте справжнього тестування
- Ви – МСК0 – документуєте складні технічні втілення
- Дорога побудови платформи така ж цінна, як і контент, який вона створює
Завершення: Простість як риса
У сучасному світі веб-розробки ми часто шукаємо складні рішення по замовчуванню.
Але іноді найпростішим рішенням є праворуч рішення. НайяскравішийM SK1MinimalBlog доводить, що ви можете побудувати функціональну, швидкуМSK3 і підтримуючу блогову платформу зMSC4
- 342 лінії CM SK1 (MarkdownBlogService
- ~120 лінії марkupу Razor МSK0 сторінки)
- 55 лінії CSS
- 1 Відлежність від NuGet МSK0Markdig)
Те, що менше ніж 520 строки коду в цілому для повноцінної blogging-платформи.
Проект служить як функціональна блогова платформа, так і нагадувачем.: перед тим, як додати складність. , запитайте себе, чи ви дійсно потребуєте цього.
Полний вихідний код можна знайти в Найяскравіший.MinimalBlog directory з головного хранилища. IM SK1 я випустим пакет нугета, як тільки я добряче задовольну кодом
Щасливі блоги!