WIP: markdown to custom components

[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
• Use JSX instead of createElement (need to transpile - 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 error.

Potential solution: yarnpkg/yarn#6669 (comment)

[m7kvqbe1]

This is a temporary layout fix (hack). The post-article component needs styling from the ground up.