Fix markdown syntax violations (#5777)

Co-authored-by: Matt Thalman <[email protected]>

Author: MichaelSimons

.markdownlint.json

@@ -1,15 +1,14 @@
 {
     "default": true,
+    "MD013": false, // line length
+    "MD024": false, // no-duplicate-heading Multiple headings with the same content
     "MD033": false, // no inline HTML
 
     // The following rules are disabled to allow the linter to be enabled.
     // Follow-up work will be done to enable these rules and clean up the violations.
     "MD001": false, // heading-increment Heading levels should only increment by one level at a time 
-    "MD013": false, // line length
     "MD022": false, // blanks-around-headings Headings should be surrounded by blank lines
-    "MD024": false, // no-duplicate-heading Multiple headings with the same content
     "MD025": false, // single-title/single-h1 Multiple top-level headings in the same document
     "MD034": false, // no-bare-urls Bare URL used
-    "MD036": false, // no-emphasis-as-heading Emphasis used instead of a heading
     "MD041": false, // first-line-heading/first-line-h1 First line in a file should be a top-level heading
 }

README.md

@@ -23,7 +23,7 @@ You can use C# or F# to write .NET apps.
 
 You are invited to [contribute new features](https://github.com/dotnet/core/blob/master/CONTRIBUTING.md), fixes, or updates, large or small; we are always thrilled to receive pull requests, and do our best to process them as fast as we can.
 
-> https://docs.microsoft.com/dotnet/core/
+> [.NET Documentation](https://docs.microsoft.com/dotnet/core/)
 
 Watch [discussions](https://github.com/dotnet/dotnet-docker/discussions/categories/announcements) for Docker-related .NET announcements.
 

documentation/azurelinux.md

@@ -152,7 +152,7 @@ flowchart TD
 
 Here's an example configuration based off of a simple ASP.NET Core app:
 
-**.csproj**
+### *.csproj
 
 ```diff
 <PropertyGroup>
@@ -162,7 +162,7 @@ Here's an example configuration based off of a simple ASP.NET Core app:
 </PropertyGroup>
 ```
 
-**Dockerfile**
+### Dockerfile
 
 ```diff
 # Learn about building .NET container images:

documentation/image-variants.md

@@ -11,23 +11,23 @@ By default, these images do not include `icu` or `tzdata`, meaning that these im
 Apps that require globalization support can use the `extra` image variant of the [dotnet/runtime-deps](https://hub.docker.com/_/microsoft-dotnet-runtime-deps/) images. Because this is only available with `runtime-deps` images, it requires a [self-contained deployment](https://learn.microsoft.com/dotnet/core/deploying/#publish-self-contained) of the application.
 Alpine, Azure Linux, and Ubuntu Chiseled images also come in `extra`, `composite`, and `aot` variants (see below).
 
-### Distroless
+## Distroless
 
 [Ubuntu Chiseled](https://ubuntu.com/engage/chiselled-ubuntu-images-for-containers) and [Azure Linux](./azurelinux.md) distroless .NET images contain only the minimum set of libraries necessary to run .NET applications with everything else removed.
 For more information, see the [Distroless .NET images documentation](./distroless.md).
 
-### `extra` (.NET 8.0+)
+## `extra` (.NET 8.0+)
 
 For apps that depend on globalization functionality, the `extra` image variant is offered for [Ubuntu Chiseled](./ubuntu-chiseled.md) and [Azure Linux](./azurelinux.md) distroless `runtime-deps`, `runtime`, and `aspnet` images as well as `runtime-deps` images for Alpine Linux.
 These `extra` images contain everything that the default images do, plus `icu` and `tzdata`.
 
-### `composite` (.NET 8.0+)
+## `composite` (.NET 8.0+)
 
 ASP.NET Core Composite images provide a smaller size on disk while keeping the performance of the default [ReadyToRun (R2R) setting](https://learn.microsoft.com/dotnet/core/deploying/ready-to-run).
 The caveat is that the composite images have tighter version coupling. This means the final app run on them cannot use handpicked custom versions of the framework and/or ASP.NET assemblies that are built into the composite binary.
 For a full technical description on how the composites work, we have a [feature doc here](https://github.com/dotnet/runtime/blob/main/docs/design/features/readytorun-composite-format-design.md).
 
-### (Preview) `aot` (.NET 8.0+)
+## (Preview) `aot` (.NET 8.0+)
 
 The `aot` images provide an optimized deployment size for [Native AOT](https://learn.microsoft.com/dotnet/core/deploying/native-aot/) compiled .NET apps.
 Native AOT has the lowest size, startup time, and memory footprint of all .NET deployment models.

documentation/scenarios/nuget-credentials.md

@@ -144,7 +144,7 @@ The `VSS_NUGET_EXTERNAL_FEED_ENDPOINTS` environment variable is a well-known var
 
 Instead, the credentials for `customfeed` are defined in the Dockerfile by making use of an `ARG` for the access token:
 
-_Linux_
+### Linux
 
 ```Dockerfile
 FROM mcr.microsoft.com/dotnet/sdk:6.0 AS build
@@ -170,7 +170,7 @@ COPY --from=build /app/out ./
 ENTRYPOINT ["dotnet", "dotnetapp.dll"]
 ```
 
-_Windows_
+### Windows
 
 ```Dockerfile
 # escape=`

eng/pipelines/README.md

@@ -1 +1,3 @@
+# .NET Docker Pipelines
+
 The contents of the `pipelines` folder are used by the .NET Core engineering infrastructure to build and publish the images.

eng/readme-templates/About.product-family.md

@@ -11,4 +11,4 @@ You can use C# or F# to write .NET apps.
 
 You are invited to [contribute new features](https://github.com/dotnet/core/blob/master/CONTRIBUTING.md), fixes, or updates, large or small; we are always thrilled to receive pull requests, and do our best to process them as fast as we can.
 
-> https://docs.microsoft.com/dotnet/core/
+> [.NET Documentation](https://docs.microsoft.com/dotnet/core/)

samples/build-for-a-platform.md

@@ -80,12 +80,12 @@ The `--platform` argument is the best way to specify the desired architecture. T
 In addition, Docker [Buildkit exposes multiple environment variables](https://github.com/dotnet/dotnet-docker/pull/4387#issuecomment-1416565213) that can be used to further conditionalize behavior. These environment variables can be controlled with the pattern demonstrated in [Dockerfile](https://github.com/mthalman/dredge/blob/main/src/Valleysoft.Dredge/Dockerfile). As mentioned, .NET doesn't support being run in emulation. The pattern in that Dockerfile results in the SDK always being run natively while the final image is affected by the `--platform` switch. This model also has the best performance since the bulk of computation is run natively.
 
 > [!NOTE]
-> We are enabling the following model in a future release: https://github.com/dotnet/dotnet-docker/issues/4388#issuecomment-1421401384.
+> We are enabling this [model](https://github.com/dotnet/dotnet-docker/issues/4388#issuecomment-1421401384) in a future release.
 
 ## .NET and QEMU
 
 Docker Desktop uses [QEMU](https://www.qemu.org/) for emulation, for example running x64 code on an Arm64 machine. [.NET doesn't support being run in QEMU](https://github.com/dotnet/core/blob/main/release-notes/8.0/supported-os.md#qemu). That means that the SDK needs to always be run natively, to enable [multi-stage build](https://docs.docker.com/build/building/multi-stage/). Multi-stage build is used by all of our samples.
 
 As a result, we need a reliable pattern that can produce multiple variants of images on one machine, but that doesn't use emulation. That's what this document describes.
 
-Context: https://gitlab.com/qemu-project/qemu/-/issues/249
+> [QEMU context](https://gitlab.com/qemu-project/qemu/-/issues/249)

samples/enable-globalization.md

@@ -35,7 +35,7 @@ System.Globalization.CultureNotFoundException: Only the invariant culture is sup
 en-us is an invalid culture identifier.
 ```
 
-This is by design. `Microsoft.Data.SqlClient` requires ICU to be installed. See https://github.com/dotnet/SqlClient/issues/220 for more information.
+This is by design. `Microsoft.Data.SqlClient` requires ICU to be installed. See this [Sql Client issue](https://github.com/dotnet/SqlClient/issues/220) for more information.
 
 ### Alpine images
 
@@ -54,7 +54,7 @@ RUN apk add --no-cache \
 
 ### Ubuntu chiseled images
 
-ICU can be added to an Ubuntu chiseled image, as demonstrated by https://github.com/ubuntu-rocks/dotnet/issues/21.
+ICU can be added to an Ubuntu chiseled image, as demonstrated in this [chisel issue](https://github.com/ubuntu-rocks/dotnet/issues/21).
 
 ## Tzdata
 

samples/releasesapp/README.md

@@ -13,7 +13,7 @@ docker build --pull -t app .
 docker run --rm app
 ```
 
-It will produce output similar to: https://gist.github.com/richlander/4701a33592abd021f767644974c0ced6
+It will produce output similar to this [example app output](https://gist.github.com/richlander/4701a33592abd021f767644974c0ced6).
 
 ## App