SplatDev.Umbraco.Markup 2.0.3

SplatDev.Umbraco.Markup

HTML and markup helper extensions for Umbraco 13 (net8.0) and Umbraco 17 (net10.0) — HTML-to-text conversion, accent removal, Razor view rendering, grid content inspection, typed content traversal, and media helper extensions.

Compatibility

Installation

dotnet add package SplatDev.Umbraco.Markup

Configuration

HTML extensions

using SplatDev.Umbraco.Markup;

// Convert HTML to plain text
string html = "<h1>Hello World</h1><p>This is <strong>HTML</strong> content.</p>";
string plainText = HtmlExtensions.ConvertHtmlToPlainText(html);
// Result: "Hello World. This is HTML content."

// Remove accents from text
string accented = "café résumé naïveté";
string unaccented = HtmlExtensions.GetWithoutAccent(accented);
// Result: "cafe resume naivete"

// Remove <p> wrapper tags from HTML
string wrapped = "<p><span>Inner content</span></p>";
string unwrapped = HtmlExtensions.RemoveParagraphWrapperTags(wrapped);
// Result: "<span>Inner content</span>"

Razor view rendering

using SplatDev.Umbraco.Markup;

// Render a Razor view to a string from a controller
public class EmailController : Controller
{
    public async Task<IActionResult> Send()
    {
        var model = new EmailViewModel { UserName = "John", OrderId = 12345 };

        string htmlBody = await this.RenderViewAsync("Emails/OrderConfirmation", model);

        // Send the rendered HTML as an email
        await _emailService.SendAsync("user@example.com", "Order Confirmed", htmlBody);
    }
}

Published content extensions

using SplatDev.Umbraco.Markup;

// Check if content has a grid value
bool hasGrid = model.HasGridValue("mainContent");

// Get typed children
var articles = model.Children<Article>()
    .Where(a => a.IsPublished())
    .OrderByDescending(a => a.PublishDate);

// Get typed descendants (recursive)
var allNewsItems = model.Descendants<NewsItem>();

// Find the first ancestor of a specific content type
var section = model.GetPublishedContentOfType<Section>();

Media extensions

using SplatDev.Umbraco.Markup;

// Get media item by UDI or ID
var image = mediaItem.GetImageUrl(width: 800, height: 600, crop: true);

// Retrieve media with crop configuration
var croppedUrl = MediaExtensions.GetCroppedUrl(mediaItem, "hero", width: 1200);

Usage

Grid value inspection

using SplatDev.Umbraco.Markup;

// Determine grid rendering strategy
if (content.HasGridValue("bodyContent"))
{
    // Render via Grid renderer with custom settings
    @Html.GetGridHtml(content, "bodyContent", "bootstrap3")
}
else
{
    // Fall back to a Block List or simple property
    @content.Value("bodyContent")
}

Full Razor view example

// In a controller action
public async Task<IActionResult> Invoice(int orderId)
{
    var order = await _orderService.GetOrderAsync(orderId);

    var html = await this.RenderViewAsync("Pdf/Invoice", order);

    var pdf = await _pdfService.GenerateFromHtmlAsync(html);

    return File(pdf, "application/pdf", $"invoice-{orderId}.pdf");
}

Features

• ConvertHtmlToPlainText — strips HTML tags and produces clean plain text with sensible whitespace
• GetWithoutAccent — removes diacritical marks (accents, umlauts, cedillas) from strings
• RemoveParagraphWrapperTags — unwraps <p> tags while preserving inner content
• RenderViewAsync<TModel> — renders Razor views to strings for emails, PDFs, or API responses
• HasGridValue — checks whether a PublishedContent item contains grid data for a given alias
• Children<T> — returns children of a node filtered and cast to a specific Umbraco model type
• Descendants<T> — recursive traversal returning all descendants cast to a specific type
• GetPublishedContentOfType — walks the ancestor tree to find the nearest parent of a given type
• MediaExtensions — helpers for media URL generation with cropping and resizing
• GridExtensions — utilities for inspecting and rendering Umbraco Grid data
• Dual-targeted for Umbraco 13 (net8.0) and Umbraco 17 (net10.0)

Key Classes

Dependencies

SplatDev.Umbraco.Markup — part of the SplatDev.Umbraco.Plugins suite. Licensed under MIT. © SplatDev Ltda.

Changelog

2.0.3 — 2026-08-24

Removes a dashboard screenshot that showed an error toast. It was captured against a site where this plugin's API was unreachable, so it advertised a broken dashboard. No screenshot is better than a misleading one; a replacement will be taken against a working install.

2.0.2 — 2026-08-24

Package metadata only: the listing now carries an icon and search tags, and the project and repository links point at the organisation that actually hosts this code. No code changes.

2.0.1 — 2026-08-24

This package now keeps a changelog. Earlier releases predate it and are not reconstructed here — consult the repository history for those. From this version on, every release records what changed for someone using it.