Contentful Markdown To Html
The markdown content is stored in the body attribute of the NewsDetail tag (via a short function that maps contentful data structure to my app structure). The HTML page has this script tag to. Monorepo with Typescript libraries for handling and rendering Contentful Rich Text documents. Packages Official. Converts markdown documents to rich text; rich-text-html-renderer. Converts rich text documents to HTML; rich-text-links. Entity (entry and asset) link extraction utilities; rich-text-plain-text-renderer. Boostnote markdown.
- Contentful Markdown To Html Converter
- Contentful Markdown To Html Code
- Contentful Markdown To Html Online
Generating HTML from Markdown at runtime is a great way to load content, but the generated HTML sits outside of the the Angular ecosystem. Here I detail a method for replacing the generated HTML elements in the DOM with dynamically created Angular components
Aim

One thing that pops up from time to time is how to get your existing content, markdown or html, into a rich text field. For markdown there's already an NPM package provided by Contentful, but I haven't been able to find anything for HTML. I figured it'd be a fun thing to build with F#, as I've never really built anything publicly with it before. Foopipes uses the configuration in foopipes.yml to fetch and process the content from Contentful. Affinity photo trial. It then invokes the Node module hugo to convert it markdown and then stores it to disk. Images (assets) are downloaded. Hugo watches for changes and generates html files from the markdown. To syntax highlight based on the language, the markdown block will be prepended with the language of your choice. For example, if we were to syntax highlight with Javascript, we would use the following: The same holds for html, css, etc: Once we’ve created our Markdown entry, it’s time for us to embed it into our Contentful rich text editor.

In this tutorial we will add regular <a>
elements to the Markdown with a custom data
attribute, and render these as HTML at runtime. We will then query the DOM for the generated HTML, and replace any native <a>
elements that contain our custom data attribute with Angular components, the templates of which will contain <a>
elements with routerLink
directives
Angular Component Template
Why?
Adding a routerLink
attribute in the Markdown would have no effect as the generated HTML is just formatted text which is outside the Angular framework. The routerLink
attributes would have no functionality. Clicking on such a link would refresh the page and reload the application. We need to generate the anchor elements as Angular components with templates, so the routerLink
directives are instantiated and navigation is handled by the Router
Markdown Content
Minecraft windows 10 4k shaders. Lets first create some Markdown content, and add the links with a custom data attribute so we can identify the elements in the generated HTML. We will be using marked.js to do the Markdown to HTML conversion
markdown.md
The markdown contains some text, some HTML syntax links with custom data attributes, and a link written in markdown syntax. We have added our routerLink text to this data-routerlink
attribute, and will process it at a later stage after the markdown has been rendered as HTML
Most markdown converters allow for raw HTML blocks to be used along with specific markdown syntax like [I'm an inline-style link](https://www.google.com)
marked.js
To install marked.js
run the following commands
Create a markdown pipe to use as either a service or a template pipe - the complete code can be seen in the StackBlitz demo section ⚡️
Trusted HTML
The HTML generated by marked.js
will be bound to an element's innerHTML
property in the page's template:
We need to use a pipe to let Angular know that the HTML being bound to the innerHTML
property is trusted:
The generated HTML applied to the <div>
creates the following elements:
At this point, although the links will work, they would refersh the page and the application would reload. This is why we need to replace the native <a>
elements with Angular components
Angular Component

Create the Angular Component
Firstly we need to create a component that will replace the native <a>
elements in the DOM
anchor.component.ts
Entry Components
As the AnchorComponent
will not be used directly in a template
i.e. declared to be a required component ahead of time, Angular will ignore it during the build/AOT compilation and tree-shaking phase, and no associated ComponentFactory
will be available to generate the component dynamically. For dynamic components wee add the AnchorComponent
to the entryComponents
array of the containing NgModule
Dynamic Components
For this example, we will be query the DOM for links containing our custom data attribute [data-routerlink]
. The attribute values will be used as inputs for the AnchorComponent
. We will use a service to dynamically create the Angular components
Component Factory Service
I've created a service with a utility function to generate components based on the Angular component type


Contentful Markdown To Html Converter
Retrieve, Create, Replace
In the host component of the markdown/HTML we will call a function to retrieve the HTML elements that match our custom data attribute, generate AnchorComponent
instances, and replace the current HTML elements with our dynamically generated components native elements. The inputs of the generated components will be initialized, and detectChanges()
will be called to check and update the component templates
Note that before the addDynamicAnchors() function is called, there is a check to see that the application is running in the browser. If the page is being rendered server side, then the HTML would suffice until pre-rendered HTML is replaced with the template at runtime
To build the components, we need a reference to the ViewContainerRef instance of the targeted HTML element, which is retrieved using the @ViewChild()
decorator. The process is detailed in the functions below..
home-page.component.ts
By default, the created components are added as immediate siblings of the ViewContainerRef
. I commented out the replace lines of code so we can see what the default behaviour would look like. Here the ViewContainerRef is div.render-div
. The two <bc-anchor>
components we added are immediatlely below the closing </div>
tag. You can also see the <a
data-routerlink='.'>
elements we want to replace
In the forEach
loop, the existing anchor elements are replaced with the Angular components hostView elements. If you inspect the image below, you can see that the <bc-anchor>
elements are no longer siblings of the div.render-div
, but have now been inserted where the <a
data-routerlink='.'>
elements were previously
Destroy
As a consequence of being added to the application via the ViewContainerRef
createComponent()
function, the generated component's ngOnDestroy()
lifecycle hook will be invoked when the containing view is being destroyed. There is one caveat with this: if the created components are part of a page/route that is being reused, they will remain in memory and possibly remain visible in the DOM (depending on where the elements were placed). Further dynamic components will be appended to the ViewContainerRef along with the existing ones. To get around this, we clear the ViewContainerRef each time the page is reused
StackBlitz Demo
Contentful Markdown To Html Code
Home Link
Contentful Markdown To Html Online
It would be remiss of me not to inlcude one of those dynamically generated links I've been talking about! So here you go, a link to the main blog page - without refreshing the browser 😉
