Enable stricter Markdown parsing and fix surfaced issues

packages/site_shared/lib/src/markdown/markdown_parser.dart

@@ -173,8 +173,13 @@ class DashMarkdownParser implements PageParser {
           }
         }
       } else if (node is md.Text) {
+        final fragment = html.HtmlParser(
+          node.text,
+          strict: true,
+          generateSpans: true,
+        ).parseFragment();
         currentNodes.addAll(
-          HtmlParser.buildNodes(html.parseFragment(node.text).nodes),
+          HtmlParser.buildNodes(fragment.nodes),
         );
       } else if (node is md.Element) {
         final nodeChildren = node.children;

sites/docs/lib/src/style_hash.dart

@@ -2,4 +2,4 @@
 // dart format off
 
 /// The generated hash of the `main.css` file.
-const generatedStylesHash = 'MrDaamQhHwYP';
+const generatedStylesHash = '';

sites/docs/src/content/add-to-app/ios/project-setup.md

@@ -166,6 +166,7 @@ The example directory structure resembles the following:
     1. Navigate to your target's **General** tab
        and add `FlutterNativeIntegration` under
        **Frameworks, Libraries, and Embedded Content**.
+
        <DashImage image="development/add-to-app/ios/project-setup-swiftpm/flutternativeintegration-library.png" caption="FlutterNativeIntegration under Frameworks, Libraries, and Embedded Content." />
 
  1. <h3>Add build settings</h3>

sites/docs/src/content/add-to-app/macos/project-setup.md

@@ -124,6 +124,7 @@ The example directory structure resembles the following:
     1. Navigate to your target's **General** tab
        and add `FlutterNativeIntegration` under
        **Frameworks, Libraries, and Embedded Content**.
+
        <DashImage image="development/add-to-app/ios/project-setup-swiftpm/flutternativeintegration-library.png" caption="FlutterNativeIntegration under Frameworks, Libraries, and Embedded Content." />
 
  1. <h3>Add build settings</h3>

sites/docs/src/content/app-architecture/case-study/dependency-injection.md

@@ -28,8 +28,8 @@ Using this diagram as a guide, the rules of engagement are as follows:
 
 | Component  | Rules of engagement                                                                                                                                                                                                                                               |
 |------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
-| View       | <ol><li> A view is only aware of exactly one view model, and is never aware of any other layer or component. When created, Flutter passes the view model to the view as an argument, exposing the view model's data and command callbacks to the view. </li></ul> |
-| ViewModel  | <ol><li>A ViewModel belongs to exactly one view, which can see its data, but the model never needs to know that a view exists.</li><li>A view model is aware of one or more repositories, which are passed into the view model's constructor.</li></ul>           |
+| View       | <ol><li> A view is only aware of exactly one view model, and is never aware of any other layer or component. When created, Flutter passes the view model to the view as an argument, exposing the view model's data and command callbacks to the view. </li></ol> |
+| ViewModel  | <ol><li>A ViewModel belongs to exactly one view, which can see its data, but the model never needs to know that a view exists.</li><li>A view model is aware of one or more repositories, which are passed into the view model's constructor.</li></ol>           |
 | Repository | <ol><li>A repository can be aware of many services, which are passed as arguments into the repository constructor.</li><li>A repository can be used by many view models, but it never needs to be aware of them.</li></ol>                                        |
 | Service    | <ol><li>A service can be used by many repositories, but it never needs to be aware of a repository (or any other object).</li></ol>                                                                                                                               |
 

sites/docs/src/content/app-architecture/case-study/ui-layer.md

@@ -410,8 +410,7 @@ a [`Dismissible`][] widget.
 Recall this code from the previous snippet:
 
 <CodePreview direction="row">
-
-  <DashImage 
+  <DashImage
     image="app-architecture/case-study/dismissible.webp"
     alt="A clip that demonstrates the 'dismissible' functionality of the Compass app."
     img-style="max-height: 480px; border-radius: 12px; border: black 2px solid;"
@@ -431,7 +430,6 @@ Recall this code from the previous snippet:
     ),
   ),
   ```
-
 </CodePreview>
 
 On the `HomeScreen`, a user's saved trip is represented by

sites/docs/src/content/install/manual.md

@@ -206,9 +206,9 @@ then extract the SDK to where you want it stored.
     download one of the following installation bundles to get the
     latest stable release of the Flutter SDK.
 
-    | Apple Silicon (ARM64)                            | Intel                                          |
-    |--------------------------------------------------|------------------------------------------------|
-    | <DownloadLatestButton os="macos" arch="arm64" /> | <DownloadLatestButton os="macos" arch="x64" /> |
+    | Apple Silicon (ARM64)                                                 | Intel                                                               |
+    |-----------------------------------------------------------------------|---------------------------------------------------------------------|
+    | <DownloadLatestButton os="macos" arch="arm64"></DownloadLatestButton> | <DownloadLatestButton os="macos" arch="x64"></DownloadLatestButton> |
 
  1. <h3>Create a folder to store the SDK</h3>
 

sites/docs/src/content/release/release-notes/changelogs/changelog-1.12.13.md

@@ -146,7 +146,7 @@ From Sun Aug 19 17:37:00 2019 -0700 to Mon Nov 25 12:05:00 2019 -0800
 
 [38932](https://github.com/flutter/flutter/pull/38932) Add build warning for non-debug desktop builds (cla: yes, tool)
 
-[38936](https://github.com/flutter/flutter/pull/38936) Fix KeySet<T> (and LogicalKeySet) hashCode calculation (cla: yes, framework)
+[38936](https://github.com/flutter/flutter/pull/38936) Fix `KeySet<T>` (and LogicalKeySet) hashCode calculation (cla: yes, framework)
 
 [38979](https://github.com/flutter/flutter/pull/38979) Adding onEnd callback to implicit animated widgets (a: animation, cla: yes, framework, waiting for tree to go green)
 
@@ -2299,7 +2299,7 @@ From Sun Aug 19 17:37:00 2019 -0700 to Mon Nov 25 12:05:00 2019 -0800
 
 [11576](https://github.com/flutter/engine/pull/11576) Minor tweaks to the Doxygen theme. (cla: yes)
 
-[11622](https://github.com/flutter/engine/pull/11622) Include <string> from font_asset_provider (cla: yes)
+[11622](https://github.com/flutter/engine/pull/11622) Include `<string>` from font_asset_provider (cla: yes)
 
 [11635](https://github.com/flutter/engine/pull/11635) [flutter_runner] Port Expose ViewBound Wireframe Functionality (cla: yes)
 

sites/docs/src/content/release/release-notes/changelogs/changelog-1.2.1.md

@@ -651,7 +651,7 @@ From Fri Nov 29 19:41:00 2018 -0800 to Thu Feb 21 20:22:00 2019 -0800
 
 [26721](https://github.com/flutter/flutter/pull/26721) Respect EditableText.keyboardAppearance (a: text input, cla: yes, f: cupertino, framework)
 
-[26722](https://github.com/flutter/flutter/pull/26722) [Material] Refactor _build<Widget> methods in BottomNavBar (cla: yes, f: material design, framework)
+[26722](https://github.com/flutter/flutter/pull/26722) [Material] Refactor `_build<Widget>` methods in BottomNavBar (cla: yes, f: material design, framework)
 
 [26727](https://github.com/flutter/flutter/pull/26727) Roll engine to d470fc65ea1cb91ae66706b320d82c4536a4da8b (cla: yes)
 
@@ -1904,7 +1904,7 @@ From Fri Nov 29 19:41:00 2018 -0800 to Thu Feb 21 20:22:00 2019 -0800
 
 [1162](https://github.com/flutter/plugins/pull/1162) [In_app_purchase] Expose nslocale and expose currencySymbol instead of currencyCode to match android (cla: yes)
 
-[1163](https://github.com/flutter/plugins/pull/1163) Change from Rectangle<num>/Point<num> to Rect/Offset for ui convenience (cla: yes)
+[1163](https://github.com/flutter/plugins/pull/1163) Change from `Rectangle<num>`/`Point<num>` to Rect/Offset for ui convenience (cla: yes)
 
 [1169](https://github.com/flutter/plugins/pull/1169) [In_app_purchase] getproductlist basic draft (cla: yes)
 

sites/docs/src/content/release/release-notes/changelogs/changelog-1.5.4.md

@@ -1730,7 +1730,7 @@ From Thu Feb 21 20:22:00 2019 -0800 to Wed May 1 16:56:00 2019 -0700
 
 [8557](https://github.com/flutter/engine/pull/8557) Update README.md (cla: yes)
 
-[8562](https://github.com/flutter/engine/pull/8562) Add missing <memory> include to text_input_model.h (cla: yes)
+[8562](https://github.com/flutter/engine/pull/8562) Add missing `<memory>` include to text_input_model.h (cla: yes)
 
 [8563](https://github.com/flutter/engine/pull/8563) Remove unused import in FlutterActivityDelegate (cla: yes)
 
@@ -1818,7 +1818,7 @@ From Thu Feb 21 20:22:00 2019 -0800 to Wed May 1 16:56:00 2019 -0700
 
 [8658](https://github.com/flutter/engine/pull/8658) Allow native bindings in secondary isolates. (cla: yes)
 
-[8659](https://github.com/flutter/engine/pull/8659) Replace ThreadLocal with ThreadLocalUniquePtr<T> (cla: yes)
+[8659](https://github.com/flutter/engine/pull/8659) Replace ThreadLocal with `ThreadLocalUniquePtr<T>` (cla: yes)
 
 [8661](https://github.com/flutter/engine/pull/8661) Put the testing lib in the flutter namespace. (cla: yes)
 

sites/docs/src/content/release/release-notes/changelogs/changelog-1.7.8.md

@@ -221,7 +221,7 @@ From Wed May 1 16:56:00 2019 -0700 to Thu Jul 18 08:04:00 2019 -0700
 
 [32410](https://github.com/flutter/flutter/pull/32410) Add ancestor and descendant finders to Driver (cla: yes, framework, waiting for tree to go green)
 
-[32425](https://github.com/flutter/flutter/pull/32425) Fix benchmark regression in layer.find<S>(Offset) (cla: yes)
+[32425](https://github.com/flutter/flutter/pull/32425) Fix benchmark regression in `layer.find<S>(Offset)` (cla: yes)
 
 [32434](https://github.com/flutter/flutter/pull/32434) Support for replacing the TabController, after disposing the old one (cla: yes, f: material design, framework)
 
@@ -1219,7 +1219,7 @@ From Wed May 1 16:56:00 2019 -0700 to Thu Jul 18 08:04:00 2019 -0700
 
 [35574](https://github.com/flutter/flutter/pull/35574) Fix semantics for floating pinned sliver app bar (a: accessibility, cla: yes, f: scrolling, framework, waiting for tree to go green)
 
-[35646](https://github.com/flutter/flutter/pull/35646) Prepare for Socket implements Stream<Uint8List> (cla: yes)
+[35646](https://github.com/flutter/flutter/pull/35646) Prepare for `Socket implements Stream<Uint8List>` (cla: yes)
 
 [35657](https://github.com/flutter/flutter/pull/35657) Remove paused check for tooling tests (cla: yes, tool)
 

sites/docs/src/content/release/release-notes/changelogs/changelog-1.9.1.md

@@ -260,7 +260,7 @@ From Fri Jun 21 22:31:55 2019 -0400 to Sun Aug 18 12:22:00 2019 -0700
 
 [35574](https://github.com/flutter/flutter/pull/35574) Fix semantics for floating pinned sliver app bar (a: accessibility, cla: yes, f: scrolling, framework, waiting for tree to go green)
 
-[35646](https://github.com/flutter/flutter/pull/35646) Prepare for Socket implements Stream<Uint8List> (cla: yes)
+[35646](https://github.com/flutter/flutter/pull/35646) Prepare for `Socket implements Stream<Uint8List>` (cla: yes)
 
 [35657](https://github.com/flutter/flutter/pull/35657) Remove paused check for tooling tests (cla: yes, tool)
 
@@ -806,7 +806,7 @@ From Fri Jun 21 22:31:55 2019 -0400 to Sun Aug 18 12:22:00 2019 -0700
 
 [37514](https://github.com/flutter/flutter/pull/37514) [flutter_tool] Remove unintended analytics screen send (cla: yes, tool)
 
-[37515](https://github.com/flutter/flutter/pull/37515) Upstream web support for IterableProperty<double> (cla: yes, framework, ☸ platform-web)
+[37515](https://github.com/flutter/flutter/pull/37515) Upstream web support for `IterableProperty<double>` (cla: yes, framework, ☸ platform-web)
 
 [37516](https://github.com/flutter/flutter/pull/37516) Kill stale TODO (a: tests, cla: yes, framework, team)
 

sites/docs/src/content/release/release-notes/release-notes-1.17.0.md

@@ -1861,7 +1861,7 @@ skipTemplateRendering: true
 [57487](https://github.com/flutter/flutter/pull/57487) Fix typo in cupertino datepicker error (cla: yes, f: cupertino, framework, waiting for tree to go green)
 
 
-[57500](https://github.com/flutter/flutter/pull/57500) SnackBarAction.createState() should have return type State<SnackBarAction> (cla: yes, f: material design, framework, waiting for tree to go green)
+[57500](https://github.com/flutter/flutter/pull/57500) SnackBarAction.createState() should have return type `State<SnackBarAction>` (cla: yes, f: material design, framework, waiting for tree to go green)
 
 
 [57511](https://github.com/flutter/flutter/pull/57511) Step 2 of 3: Change opt-in default for debugCheckHasMaterialLocalizations assertion on TextField (a: internationalization, a: text input, cla: yes, f: material design, framework, team, waiting for tree to go green)
@@ -2206,7 +2206,7 @@ skipTemplateRendering: true
 [59310](https://github.com/flutter/flutter/pull/59310) Dismiss modal routes with a keyboard shortcut (cla: yes, f: material design, framework, waiting for tree to go green)
 
 
-[59317](https://github.com/flutter/flutter/pull/59317) Implement Comparable<TimeOfDay> (cla: yes, f: material design, framework, waiting for tree to go green)
+[59317](https://github.com/flutter/flutter/pull/59317) Implement `Comparable<TimeOfDay>` (cla: yes, f: material design, framework, waiting for tree to go green)
 
 
 [59342](https://github.com/flutter/flutter/pull/59342) Add support for horizontal and vertical double-arrow system cursors (cla: yes, framework, waiting for tree to go green)
@@ -2341,7 +2341,7 @@ skipTemplateRendering: true
 [59966](https://github.com/flutter/flutter/pull/59966) Added a filterQuality parameter to texture (a: quality, a: video, cla: yes, framework, waiting for tree to go green)
 
 
-[59981](https://github.com/flutter/flutter/pull/59981) Revert "Implement Comparable<TimeOfDay>" (cla: yes, f: material design, framework)
+[59981](https://github.com/flutter/flutter/pull/59981) Revert "Implement `Comparable<TimeOfDay>`" (cla: yes, f: material design, framework)
 
 
 [59982](https://github.com/flutter/flutter/pull/59982) [flutter_driver] Fix tracing of startup events (a: tests, cla: yes, framework)
@@ -3671,7 +3671,7 @@ skipTemplateRendering: true
 [57332](https://github.com/flutter/flutter/pull/57332) Add autofill support for TextFormField (cla: yes, f: material design, framework, waiting for tree to go green)
 
 
-[57500](https://github.com/flutter/flutter/pull/57500) SnackBarAction.createState() should have return type State<SnackBarAction> (cla: yes, f: material design, framework, waiting for tree to go green)
+[57500](https://github.com/flutter/flutter/pull/57500) SnackBarAction.createState() should have return type `State<SnackBarAction>` (cla: yes, f: material design, framework, waiting for tree to go green)
 
 
 [57511](https://github.com/flutter/flutter/pull/57511) Step 2 of 3: Change opt-in default for debugCheckHasMaterialLocalizations assertion on TextField (a: internationalization, a: text input, cla: yes, f: material design, framework, team, waiting for tree to go green)
@@ -3848,7 +3848,7 @@ skipTemplateRendering: true
 [59310](https://github.com/flutter/flutter/pull/59310) Dismiss modal routes with a keyboard shortcut (cla: yes, f: material design, framework, waiting for tree to go green)
 
 
-[59317](https://github.com/flutter/flutter/pull/59317) Implement Comparable<TimeOfDay> (cla: yes, f: material design, framework, waiting for tree to go green)
+[59317](https://github.com/flutter/flutter/pull/59317) Implement `Comparable<TimeOfDay>` (cla: yes, f: material design, framework, waiting for tree to go green)
 
 
 [59363](https://github.com/flutter/flutter/pull/59363) Add material state mouse cursor to TextField (a: text input, cla: yes, customer: octopod, f: material design, framework, waiting for tree to go green)
@@ -3905,7 +3905,7 @@ skipTemplateRendering: true
 [59937](https://github.com/flutter/flutter/pull/59937) Update tooltip_theme_test to unblock Dart SDK roll (cla: yes, f: material design, framework, waiting for tree to go green)
 
 
-[59981](https://github.com/flutter/flutter/pull/59981) Revert "Implement Comparable<TimeOfDay>" (cla: yes, f: material design, framework)
+[59981](https://github.com/flutter/flutter/pull/59981) Revert "Implement `Comparable<TimeOfDay>`" (cla: yes, f: material design, framework)
 
 
 [59992](https://github.com/flutter/flutter/pull/59992) Revert "[PageTransitionsBuilder] Fix 'ZoomPageTransition' built more than once" (cla: yes, f: material design, framework)
@@ -7081,7 +7081,7 @@ There were 1526 pull requests.
 
 [48472](https://github.com/flutter/flutter/pull/48472) Test hot reload targeting a Fuchsia device (cla: yes, d: examples, platform-fuchsia, team, tool, waiting for tree to go green)
 
-[48482](https://github.com/flutter/flutter/pull/48482) use isA<Xxx>() matcher (a: accessibility, a: internationalization, a: tests, cla: yes, f: cupertino, f: material design, framework, team, tool, waiting for tree to go green)
+[48482](https://github.com/flutter/flutter/pull/48482) use `isA<Xxx>()` matcher (a: accessibility, a: internationalization, a: tests, cla: yes, f: cupertino, f: material design, framework, team, tool, waiting for tree to go green)
 
 [48486](https://github.com/flutter/flutter/pull/48486) Add highContrast to FakeAccessibilityFeatures test (a: accessibility, a: tests, cla: yes, framework, platform-ios, waiting for tree to go green)
 
@@ -9201,7 +9201,7 @@ There were 1526 pull requests.
 
 [53799](https://github.com/flutter/flutter/pull/53799) Add LICENSE file to packages/flutter, add test to make sure it's picked up. (a: build, cla: yes, team)
 
-[53834](https://github.com/flutter/flutter/pull/53834) Replace isInstanceOf<T> uses with isA<T> (cla: yes, framework)
+[53834](https://github.com/flutter/flutter/pull/53834) Replace `isInstanceOf<T>` uses with `isA<T>` (cla: yes, framework)
 
 [53838](https://github.com/flutter/flutter/pull/53838) Roll engine 46277fd2ca54..1adfd639b465 (23 commits) (cla: yes, waiting for tree to go green)
 
@@ -10607,7 +10607,7 @@ There were 1421 pull requests.
 
 [16440](https://github.com/flutter/engine/pull/16440) fix bad reference to maxDiffRatePercent (cla: yes)
 
-[16442](https://github.com/flutter/engine/pull/16442) Include <memory> in hb_wrapper.h because unique_ptr is used. (cla: yes)
+[16442](https://github.com/flutter/engine/pull/16442) Include `<memory>` in hb_wrapper.h because unique_ptr is used. (cla: yes)
 
 [16446](https://github.com/flutter/engine/pull/16446) Relax timing restrictions on WakeUpTimersAreSingletons. (cla: yes)
 
@@ -11317,7 +11317,7 @@ There were 1421 pull requests.
 
 [16925](https://github.com/flutter/engine/pull/16925) Roll fuchsia/sdk/core/mac-amd64 from VQHsS... to 8HrJn... (cla: yes, waiting for tree to go green)
 
-[16928](https://github.com/flutter/engine/pull/16928) Make GetDefaultFontFamilies return a vector<string> instead of a string. (cla: yes)
+[16928](https://github.com/flutter/engine/pull/16928) Make GetDefaultFontFamilies return a `vector<string>` instead of a string. (cla: yes)
 
 [16930](https://github.com/flutter/engine/pull/16930) [web] Engine integration test (cla: yes, platform-web)