Markdig fixes - Part 1 (#2550)

* markdig fixes

* undo table change

* readded trailing spaces

* Apply suggestions from peer review

Co-Authored-By: Ron Petrusha <[email protected]>

* fix broken link

* fix formatting

Author: mairaw

xml/System.ComponentModel.Design/IDesignerOptionService.xml

@@ -163,7 +163,7 @@
           <format type="text/markdown"><![CDATA[  
   
 ## Remarks  
- The `pageName` parameter should consist of "WindowsFormsDesigner\*CategoryName*", where *CategoryName* is an options category name without any white space characters. The category name is typically "General". Therefore, you can access the "General" designer options category with the English page name "WindowsFormsDesigner\General".  
+ The `pageName` parameter should consist of "WindowsFormsDesigner\\*CategoryName*", where *CategoryName* is an options category name without any white space characters. The category name is typically "General". Therefore, you can access the "General" designer options category with the English page name "WindowsFormsDesigner\General".  
   
 > [!NOTE]
 >  The page and value names are always expected in English. Therefore, the following table is provided to help you access the options you want.  

xml/System.Globalization/IdnMapping.xml

@@ -43,8 +43,8 @@
 > [!IMPORTANT]
 >  In the [!INCLUDE[net_v45](~/includes/net-v45-md.md)], the <xref:System.Globalization.IdnMapping> class supports different versions of the IDNA standard, depending on the operating system in use:  
 >   
->  -   When run on [!INCLUDE[win8](~/includes/win8-md.md)], it supports the 2008 version of the IDNA standard outlined by [RFC 5891: Internationalized Domain Names in Applications (IDNA): Protocol](https://go.microsoft.com/fwlink/?LinkId=231875).  
-> -   When run on earlier versions of the Windows operating system, it supports the 2003 version of the standard outlined by [RFC 3490: Internationalizing Domain Names in Applications (IDNA)](https://go.microsoft.com/fwlink/?LinkId=158110).  
+> - When run on [!INCLUDE[win8](~/includes/win8-md.md)], it supports the 2008 version of the IDNA standard outlined by [RFC 5891: Internationalized Domain Names in Applications (IDNA): Protocol](https://go.microsoft.com/fwlink/?LinkId=231875).
+> - When run on earlier versions of the Windows operating system, it supports the 2003 version of the standard outlined by [RFC 3490: Internationalizing Domain Names in Applications (IDNA)](https://go.microsoft.com/fwlink/?LinkId=158110).
 >   
 >  See [Unicode Technical Standard #46: IDNA Compatibility Processing](https://go.microsoft.com/fwlink/?LinkId=232459) for the differences in the way these standards handle particular sets of characters.  
   

xml/System.Net.Configuration/ProxyElement.xml

@@ -53,15 +53,7 @@
       <Parameters />
       <Docs>
         <summary>Initializes a new instance of the <see cref="T:System.Net.Configuration.ProxyElement" /> class.</summary>
-        <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
-  
--  
-  
- ]]></format>
-        </remarks>
+        <remarks>To be added.</remarks>
         <altmember cref="T:System.Net.IAuthenticationModule" />
         <altmember cref="T:System.Net.AuthenticationManager" />
         <related type="Article" href="~/docs/framework/configure-apps/file-schema/network/index.md">Network Settings Schema</related>

xml/System.Web.Services.Protocols/SoapExtension.xml

@@ -258,19 +258,13 @@
   
 -   Class constructor - The class constructor is called every time a SOAP extension is instantiated and is typically used to initialize member variables.  
   
--   <xref:System.Web.Services.Protocols.SoapExtension.GetInitializer%2A> - <xref:System.Web.Services.Protocols.SoapExtension.GetInitializer%2A>, however, is called just once, the first time a SOAP request is made to an XML Web services method. If a custom attribute is applied to the XML Web service method, the <xref:System.Web.Services.Protocols.SoapExtension.GetInitializer%2A> method is invoked. This allows the SOAP extension to interrogate the <xref:System.Web.Services.Protocols.LogicalMethodInfo> of an XML Web service method for prototype information or to access extension-specific data passed by a class deriving from <xref:System.Web.Services.Protocols.SoapExtensionAttribute>. The return value is cached by ASP.NET and passed into subsequent <xref:System.Web.Services.Protocols.SoapExtension.Initialize%2A> methods. Therefore, initialization done in <xref:System.Web.Services.Protocols.SoapExtension.GetInitializer%2A> is encapsulated essentially into a one-time performance hit.  
-  
--   <xref:System.Web.Services.Protocols.SoapExtension.Initialize%2A> - <xref:System.Web.Services.Protocols.SoapExtension.Initialize%2A> is called every time a SOAP request is made to an XML Web service method, but has an advantage over the class constructor, in that the <xref:System.Object> initialized in <xref:System.Web.Services.Protocols.SoapExtension.GetInitializer%2A> is passed to it.  
+-   <xref:System.Web.Services.Protocols.SoapExtension.GetInitializer%2A> - This method is called just once, the first time a SOAP request is made to an XML Web services method. If a custom attribute is applied to the XML Web service method, the <xref:System.Web.Services.Protocols.SoapExtension.GetInitializer%2A> method is invoked. This allows the SOAP extension to interrogate the <xref:System.Web.Services.Protocols.LogicalMethodInfo> of an XML Web service method for prototype information or to access extension-specific data passed by a class deriving from <xref:System.Web.Services.Protocols.SoapExtensionAttribute>. The return value is cached by ASP.NET and passed into subsequent <xref:System.Web.Services.Protocols.SoapExtension.Initialize%2A> methods. Therefore, initialization done in <xref:System.Web.Services.Protocols.SoapExtension.GetInitializer%2A> is encapsulated essentially into a one-time performance hit.  
   
--  
+-   <xref:System.Web.Services.Protocols.SoapExtension.Initialize%2A> - This method is called every time a SOAP request is made to an XML Web service method, but has an advantage over the class constructor, in that the <xref:System.Object> initialized in <xref:System.Web.Services.Protocols.SoapExtension.GetInitializer%2A> is passed to it.
   
 > [!NOTE]
 >  You can also add a SOAP extension without deriving from <xref:System.Web.Services.Protocols.SoapExtensionAttribute> by using the [\<soapExtensionTypes> Element](https://msdn.microsoft.com/library/7a373a98-6d82-4f8d-a6fc-2996da3fd54c) in a configuration file. For details, see [\<soapExtensionTypes> Element](https://msdn.microsoft.com/library/7a373a98-6d82-4f8d-a6fc-2996da3fd54c) and [SOAP Message Modification Using SOAP Extensions](https://msdn.microsoft.com/library/97d81ace-95e7-4acc-ae39-9692a0021e95).  
   
--  
-  
-   
-  
 ## Examples  
  The following example demonstrates how you can use the data cached during the <xref:System.Web.Services.Protocols.SoapExtension.GetInitializer%2A> method.  
   
@@ -324,4 +318,4 @@
       </Docs>
     </Member>
   </Members>
-</Type>
+</Type>

xml/System.Windows.Documents/FixedPage.xml

@@ -364,18 +364,14 @@
 -   <xref:System.Windows.Documents.FixedPage.ContentBox%2A>.<xref:System.Windows.Rect.Bottom%2A> must be greater than or equal to (<xref:System.Windows.Documents.FixedPage.ContentBox%2A>.<xref:System.Windows.Rect.Top%2A>+1).  
   
 -   For rules about the relative sizes of the <xref:System.Windows.Documents.FixedPage.ContentBox%2A> and the <xref:System.Windows.Documents.FixedPage.BleedBox%2A>, see the topic <xref:System.Windows.Documents.FixedPage.BleedBox%2A?displayProperty=nameWithType>.  
-  
--  
-  
+ 
 <a name="dependencyPropertyInfo_ContentBox"></a>   
 ## Dependency Property Information  
   
 |||  
 |-|-|  
-|-   Identifier field|<xref:System.Windows.Documents.FixedPage.ContentBoxProperty>|  
-|Metadata properties set to `true`|-   None|  
-  
--  
+|Identifier field|<xref:System.Windows.Documents.FixedPage.ContentBoxProperty>|  
+|Metadata properties set to `true`|None|
   
  ]]></format>
         </remarks>

xml/System.Windows.Documents/Hyperlink.xml

@@ -32,7 +32,7 @@
       <format type="text/markdown"><![CDATA[  
   
 ## Remarks  
- <xref:System.Windows.Documents.Hyperlink> implements the <xref:System.Windows.Documents.Hyperlink.NavigateUri%2A> property that you set with the <xref:System.Uri> of the content that should be navigated to when the Hyperlink is clicked. <xref:System.Windows.Documents.Hyperlink> navigation can only occur, however, if either the direct or indirect parent of a <xref:System.Windows.Documents.Hyperlink> is a navigation host, including <xref:System.Windows.Navigation.NavigationWindow>, <xref:System.Windows.Controls.Frame>, or any browser that can host [!INCLUDE[TLA2#tla_xbap#plural](~/includes/tla2sharptla-xbapsharpplural-md.md)] (which includes [!INCLUDE[TLA2#tla_ie7](~/includes/tla2sharptla-ie7-md.md)], [!INCLUDE[TLA2#tla_ie6](~/includes/tla2sharptla-ie6-md.md)], and Firefox 2.0+). For more information, see the **Navigation Hosts** topic in [Navigation Overview](~/docs/framework/wpf/app-development/navigation-overview.md).  
+ <xref:System.Windows.Documents.Hyperlink> implements the <xref:System.Windows.Documents.Hyperlink.NavigateUri%2A> property that you set with the <xref:System.Uri> of the content that should be navigated to when the Hyperlink is clicked. <xref:System.Windows.Documents.Hyperlink> navigation can only occur, however, if either the direct or indirect parent of a <xref:System.Windows.Documents.Hyperlink> is a navigation host, including <xref:System.Windows.Navigation.NavigationWindow>, <xref:System.Windows.Controls.Frame>, or any browser that can host XBAPs (which includes Internet Explorer 6 and later versions, and Firefox 2.0+). For more information, see the **Navigation Hosts** topic in [Navigation Overview](~/docs/framework/wpf/app-development/navigation-overview.md).  
   
  <xref:System.Windows.Documents.Hyperlink> enforces a strong content model for child content. See [TextElement Content Model Overview](~/docs/framework/wpf/advanced/textelement-content-model-overview.md) for more information about the <xref:System.Windows.Documents.Hyperlink> content model.  
   
@@ -569,10 +569,10 @@
         <ReturnType>System.Uri</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>Gets or sets a [!INCLUDE[TLA2#tla_uri](~/includes/tla2sharptla-uri-md.md)] to navigate to when the <see cref="T:System.Windows.Documents.Hyperlink" /> is activated.</summary>
-        <value>The <see cref="T:System.Uri" /> to navigate to when the <see cref="T:System.Windows.Documents.Hyperlink" /> is activated. The default is <see langword="null" />.  
+        <summary>Gets or sets a URI to navigate to when the <see cref="T:System.Windows.Documents.Hyperlink" /> is activated.</summary>
+        <value>The URI to navigate to when the <see cref="T:System.Windows.Documents.Hyperlink" /> is activated. The default is <see langword="null" />.  
 
- <block subset="none" type="note"><para><see cref="T:System.Windows.Documents.Hyperlink" /> can navigate to the value of the <see cref="P:System.Windows.Documents.Hyperlink.NavigateUri" /> property only if either the direct or indirect parent of a <see cref="T:System.Windows.Documents.Hyperlink" /> is a navigation host, including <see cref="T:System.Windows.Navigation.NavigationWindow" />, <see cref="T:System.Windows.Controls.Frame" />, or any browser that can host [!INCLUDE[TLA2#tla_xbap#plural](~/includes/tla2sharptla-xbapsharpplural-md.md)] (which includes [!INCLUDE[TLA2#tla_ie7](~/includes/tla2sharptla-ie7-md.md)], [!INCLUDE[TLA2#tla_ie6](~/includes/tla2sharptla-ie6-md.md)], and Firefox 2.0+). For more information, see the **Navigation Hosts** section in [Navigation Overview](~/docs/framework/wpf/app-development/navigation-overview.md).  
+ <block subset="none" type="note"><para><see cref="T:System.Windows.Documents.Hyperlink" /> can navigate to the value of the <see cref="P:System.Windows.Documents.Hyperlink.NavigateUri" /> property only if either the direct or indirect parent of a <see cref="T:System.Windows.Documents.Hyperlink" /> is a navigation host, including <see cref="T:System.Windows.Navigation.NavigationWindow" />, <see cref="T:System.Windows.Controls.Frame" />, or any browser that can host XBAPs (which includes Internet Explorer 6 and later versions, and Firefox 2.0+). For more information, see the Navigation Hosts section in <see href="~/docs/framework/wpf/app-development/navigation-overview.md">Navigation Overview</see>.  
 
 </para></block></value>
         <remarks>
@@ -960,4 +960,4 @@
       </Docs>
     </Member>
   </Members>
-</Type>
+</Type>

xml/System.Windows.Documents/Typography.xml

@@ -85,7 +85,10 @@ Text using OpenType capitals
 |<xref:System.Windows.Documents.Typography.StylisticSet20%2A>|<xref:System.Boolean>|`false`|  
 |<xref:System.Windows.Documents.Typography.Variants%2A>|<xref:System.Windows.FontVariants.Inferior> &#124; <xref:System.Windows.FontVariants.Normal> &#124; <xref:System.Windows.FontVariants.Ordinal> &#124; <xref:System.Windows.FontVariants.Ruby> &#124; <xref:System.Windows.FontVariants.Subscript> &#124; <xref:System.Windows.FontVariants.Superscript>|<xref:System.Windows.FontVariants>.<xref:System.Windows.FontVariants.Normal>|  
   
- All dependency properties of this class also have an attached property usage in [!INCLUDE[TLA2#tla_xaml](~/includes/tla2sharptla-xaml-md.md)]. For instance, you can set the <xref:System.Windows.Documents.Typography.AnnotationAlternates%2A> property through this syntax: `<`*object*``**Typography.AnnotationAlternates**`="`*value*`".../>`  
+ All dependency properties of this class also have an attached property usage in [!INCLUDE[TLA2#tla_xaml](~/includes/tla2sharptla-xaml-md.md)]. 
+ For instance, you can set the <xref:System.Windows.Documents.Typography.AnnotationAlternates%2A> property through this syntax: 
+
+ <*object* **Typography.AnnotationAlternates**="*`value`*" .../>
   
    
   
@@ -5705,4 +5708,4 @@ Example of subscripts
       </Docs>
     </Member>
   </Members>
-</Type>
+</Type>

xml/System.Windows.Media/PointCollection.xml

@@ -83,7 +83,7 @@
  *oneOrMorePoints*  
  One or more <xref:System.Windows.Point> values, with each pair delimited by a single comma and/or one or more spaces.  
   
- <xref:System.Windows.Point> *[delimiter* <xref:System.Windows.Point> *]\**  
+ <xref:System.Windows.Point>_[delimiter_<xref:System.Windows.Point>_]\*_
   
  For example, `"0,0 100,100 200,100"` and `"0,0,100,100,200,100"` are both valid.