refactor: markdownlint rules (#259)

* refactor(markdownlint): remove inline HTML allowance

if we would like to add specific tags in the future, we could so via a whitelist from now on

* refactor: it doesn't make any sense to deactivate this rule

Author: mfranzke

.markdown-lint.yml

@@ -29,8 +29,6 @@ MD026:
 MD028: false
 MD029: false # Ordered list item prefix
 MD030: false
-MD033: false # Allow inline HTML
-MD034: false
 MD036: false # Emphasis used instead of a heading
 MD049: false # emphasis-style Emphasis style should be consistent
 MD053: false

.mdlrc

@@ -1 +1 @@
-rules "~MD002", "~MD010", "~MD013", "~MD024", "~MD033"
+rules "~MD002", "~MD010", "~MD013", "~MD024"

README.md

@@ -1,7 +1,11 @@
 <!-- markdownlint-configure-file { "MD013": false, "MD041":false } -->
 
+<!-- markdownlint-disable MD033 -->
+
 <img src="source/samples/images/header_image_0.guetzli.jpg" alt="" srcset="source/samples/images/header_image_0.guetzli.2x.jpg 2x, source/samples/images/header_image_0.guetzli.3x.jpg 3x"> <!-- width="830" height="276" //-->
 
+<!-- markdownlint-enable MD033 -->
+
 # DB UI Core
 
 ![Apache 2.0 license badge](https://img.shields.io/badge/License-Apache_2.0-blue.svg)
@@ -107,7 +111,7 @@ Please mind the [conventions for git commits](/docs/conventions.adoc#user-conten
 
 <!-- markdownlint-disable MD033 -->
 
-This is only the first version of our framework and we really want your feedback - either within the <a href="https://db.de/krnm74" target="_blank" rel="noopener noreferrer">DB UI Channel by Web Dev Community in Microsoft Teams (only available DB internally)</a>, or directly at [[email protected]](mailto:[email protected]). <!-- markdownlint-disable MD033 -->
+This is only the first version of our framework and we really want your feedback - either within the <a href="https://db.de/krnm74" target="_blank" rel="noopener noreferrer">DB UI Channel by Web Dev Community in Microsoft Teams (only available DB internally)</a>, or directly at [[email protected]](mailto:[email protected]).
 We're particularly keen to add as many examples to the behaviours as possible, to further clarify them.
 
 ## FAQ

source/_patterns/.mdlrc

@@ -1 +1 @@
-rules "~MD002", "~MD010", "~MD013", "~MD024", "~MD033", "~MD041"
+rules "~MD002", "~MD010", "~MD013", "~MD024", "~MD041"

source/_patterns/00-global.md

@@ -6,6 +6,10 @@ The global category defines visual elements such as color, font families, and mo
 
 ## Give us your feedback
 
+<!-- markdownlint-disable MD033 -->
+
 This is only the beta version of our framework and we really want your feedback - either within the <a href="https://db.de/krnm74" target="_blank" rel="noopener noreferrer">DB UI Channel by Web Dev Community in Microsoft Teams (only available DB internally)</a>, or directly at [[email protected]](mailto:[email protected]).
 
+<!-- markdownlint-enable MD033 -->
+
 We're particularly keen to add as many examples to the behaviours as possible, to further clarify them.

source/_patterns/01-elements/image/_image.md

@@ -36,7 +36,7 @@ Attention: `PNG` is even also often used for pictures, even though that the spec
 
 Regarding images that need to have some kind of full or partial transparency, you could use either `GIF` (full) or `PNG` (most likely `PNG-24` for partial) transparency.
 
-Or use SVG masks, as this beautiful concept shows: https://github.blog/2021-01-29-making-githubs-new-homepage-fast-and-performant/#serving-the-perfect-image
+Or use SVG masks, as this beautiful concept shows: <https://github.blog/2021-01-29-making-githubs-new-homepage-fast-and-performant/#serving-the-perfect-image>
 
 ### Diagrams, drawings, and charts
 
@@ -46,7 +46,7 @@ Source: <https://developer.mozilla.org/en-US/docs/Web/Media/Formats/Image_types#
 
 ## Further image compressions
 
-On top of the possibilities mentioned above regarding image optimizations (Google Guetzli & JPEGMini) you could as well have a look at both [ImageAlpha (for PNG)](https://pngmini.com) and [ImageOptim (for all)](https://imageoptim.com/), both available for Mac and the first [both both other GUI and command-line variants](https://pngquant.org) and the latter as well as a webservice. Another great online tool that works entirely in the browser and doesn't even need to process your data on their servers (due to WebAssembly and some other cool stuff) is <https://squoosh.app>. Nowadays they additionally provide a CLI version of their software and new cool image formats, check out their version 2: https://web.dev/squoosh-v2/
+On top of the possibilities mentioned above regarding image optimizations (Google Guetzli & JPEGMini) you could as well have a look at both [ImageAlpha (for PNG)](https://pngmini.com) and [ImageOptim (for all)](https://imageoptim.com/), both available for Mac and the first [both both other GUI and command-line variants](https://pngquant.org) and the latter as well as a webservice. Another great online tool that works entirely in the browser and doesn't even need to process your data on their servers (due to WebAssembly and some other cool stuff) is <https://squoosh.app>. Nowadays they additionally provide a CLI version of their software and new cool image formats, check out their version 2: <https://web.dev/squoosh-v2/>
 
 Some further information on this topic are provided on this page: <https://dev.to/prototyp/optimizing-images-for-the-web-an-in-depth-guide-4j7d>
 

source/_patterns/01-elements/video/video.md

@@ -9,8 +9,8 @@ TODO: Not included within the styleguide at the moment, needs to get investigate
 
 Please keep in mind to provide subtitles to your video content via WebVTT files:
 
-- http://html5doctor.com/video-subtitling-and-webvtt/
-- https://www.vtt-creator.com/
+- <http://html5doctor.com/video-subtitling-and-webvtt/>
+- <https://www.vtt-creator.com/>
 
 These do not only help people with hearing disabilities, but other users as well that couldn't listen to the sound due to their environment, like e.g. travelling in public transport.