WIP: Feature/EN-688 markdown to custom component

[m7kvqbe1]

Related Jira issue:

https://rn-nelson.atlassian.net/browse/EN-688

Overview

Implement a pre-parser for the component library README.md files to convert MD into MDX.

Reason

The README.md files need to stay as pure markdown, but in order to display them on the docs-site some markdown structures need to be converted to their corresponding docs-site JSX representation (presentational components).

Work carried out

• Implement pre-parser and translators (CodeHighlighter & DataTable)
• Fix issues with Gatsby MDX parser errors (need to escape some prop values)
• Implement transformTableData for DataTable translator
• Generate code examples (need to transpile JSX - maybe use @babel/node CLI)
• Pass code examples as tree of React nodes (use props.children for render)
• Deal with yarn audit security error (marked ^0.6.2 required)

Screenshot

Developer notes

There is a known issue with Yarn workspaces and resolutions: yarnpkg/yarn#5039

This is currently blocking me from dealing with the audit failure.

Potential solution: yarnpkg/yarn#6669 (comment)