$re = [regex]'(?s)\s*\n[\s-[\n]]*\*\*(Remark|Example|Syntax)s?\*\*[\s-[\n]]*\n\s*'
$fList=@();ls *.md -recurse | %{if($re.IsMatch((gc $_) -join "`n")){$fList+=$_;}};$fList=($fList|sort -unique)
filter fltr{
   $content=(gc $_) -join "`n"
   $mList = $re.matches($content)
   if($mList.count -gt 0){
      foreach($ToFind in $mList.value){
        $ToSet = ($ToFind -replace '(?s)\s+\*+(?''sName''[^*]+).*',("`n`n"+'## ${sName}'+"`n`n"))
        $content = $content.replace($ToFind,$ToSet)
      }
      $pth = resolve-path $_ -relative
#      $pth = ".\ReviewTmp\$pth";$null = (ni $pth -type file -force)
      sc $pth $content -force
      resolve-path $pth -relative
   }
}
$fList | fltr | ac UpdatedFiles.txt
#gc .\ReviewTmp\access\Concepts\Miscellaneous\required-client-settings.md