fix: escape pipes in comments and expand object type in props table (#286)

Author: tgreyuk

packages/typedoc-plugin-markdown/src/resources/helpers/property-table.ts

@@ -56,15 +56,17 @@ export default function () {
         row.push(nameCol.join(' '));
         row.push(
           Handlebars.helpers.type
-            .call(propertyType, 'object')
+            .call(propertyType)
             .replace(/(?<!\\)\|/g, '\\|'),
         );
 
         if (hasComments) {
           const comments = getComments(property);
           if (comments) {
             row.push(
-              stripLineBreaks(Handlebars.helpers.comments.call(comments)),
+              stripLineBreaks(
+                Handlebars.helpers.comments.call(comments),
+              ).replace(/\|/g, '\\|'),
             );
           } else {
             row.push('-');

packages/typedoc-plugin-markdown/test/specs/__snapshots__/declarations.spec.ts.snap

@@ -152,8 +152,8 @@ exports[`Declarations: should compile object literal declaration 1`] = `
 | :------ | :------ |
 | \`valueA\` | \`number\` |
 | \`valueB\` | \`boolean\` |
-| \`valueC\` | \`Object\` |
-| \`valueX\` | \`Object\` |
+| \`valueC\` | {} |
+| \`valueX\` | { \`valueA\`: \`number\`[] ; \`valueZ\`: \`string\` = 'foo' } |
 | \`valueX.valueA\` | \`number\`[] |
 | \`valueX.valueZ\` | \`string\` |
 | \`valueY\` | () => \`string\` |
@@ -172,7 +172,7 @@ exports[`Declarations: should compile type literal declaration 1`] = `
 | :------ | :------ | :------ |
 | \`valueA?\` | \`number\` | Comments for valueA |
 | \`valueB?\` | \`boolean\` | - |
-| \`valueX\` | \`Object\` | Comment for valueX |
+| \`valueX\` | { \`valueA\`: \`number\`[] ; \`valueY\`: (\`z\`: \`string\`) => { \`a\`: \`string\` ; \`b\`: \`string\`  } ; \`valueZ\`: \`string\`  } | Comment for valueX |
 | \`valueX.valueA\` | \`number\`[] | - |
 | \`valueX.valueY\` | (\`z\`: \`string\`) => { \`a\`: \`string\` ; \`b\`: \`string\`  } | - |
 | \`valueX.valueZ\` | \`string\` | Nested comment for valueZ |