Back to Tech landscape

Markdown

Design & UX

Authoring format for docs and content

Official documentation (opens in a new tab)

Overview

Markdown is the authoring format for tech landscape detail bodies, blog JSON, and MkDocs—Markdig turns trusted repo markdown into HTML on the marketing site without embedding raw HTML from contributors.

Figma and documented tokens feed ConnectSoft Blazor UIKit and marketing surfaces—so spacing, themes, and components stay consistent across Factory templates and public sites.

When client brands differ, we still anchor specs in accessible patterns and component libraries that engineers can implement without guesswork.

Strong UX specs shorten delivery cycles— we connect design artifacts to Azure-hosted products your teams can evolve safely.

Why we use it:

  • Trusted-content pipeline (no arbitrary HTML in JSON)
  • Consistent heading and list structure for Markdig
  • Code fences with copy toolbar where needed
  • Pair with Mermaid blocks in docs and UX packs
  • Single source of truth before implementation starts
  • Responsive, accessible specs for light and dark themes
  • Component libraries that map cleanly to Blazor and Angular

Ready to work with us?

Let's discuss how our team can help achieve your digital goals