A while ago Contentful released a new feature called Rich Text which is a new field type that allows you to create rich text content. It gives you the possibility to format your textual content in all the ways you're used to, making text bold, adding headers, inserting lists, quotes and code etc. This isn't all that exciting as it's been available through the markdown field type for a long time, however, rich text fields are quite different from traditional markdown or html editors. A rich text field stores the content as a typed json structure. Turning your paragraph into something like this:

Migrating from markdown to rich text. If you already have markdown fields, you can use the rich text from markdown package. It automatically converts many specific markdown nodes to rich text, with the option of adding a callback for unsupported nodes. See the documentation for the package for more examples and the list of supported markdown nodes. Render all the contents of a JSON response to HTML. Apply a custom rendering function to an embedded entry. Apply a custom rendering function to a default node, like a heading or a link, thereby applying personalized style and logic to the markup of an application.

This typed structure (well, as typed as vanilla javascript can be anyway) allows for greater flexibility and programmability than, for example, markdown. It does come with a cost in excessive bloat, though. Compare the following two paragraps in markdown, html and rich text.

Markdown

HTML

Rich text

That's a lot of json for two small paragraphs, but like I eluded to above, it does come with significant benefits as well. Flexibility, you can create new custom node types with minimal changes to the structure. Programmability, since the structure is very rigid, it's much easier to build a program reading this structure and producing some output than writing a markdown or html parser.

I've played around quite a lot with the rich text structure while I was building support for it into the .NET SDK and I will admit to being quite skeptical at first. I felt like everything rich text could do markdown could do better, but during implementation I came around and changed my mind. A json structure like rich text made writing a parser for the json a breeze, I just created a few classes and a custom deserializer and I suddenly had the entire content structure in strongly typed c#.

Hidalgo port devices driver download for windows. As adoption of the rich text field now has grown significantly, even though the feature itself is still in beta, the number of questions around it in the Contentful Community slack has grown as well. 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.

Contentful Markdown To Html Converter

I started out by figuring out the different types I needed and came up with the following.

Contentful Markdown To Html

I then started out by parsing the html using the HtmlParser in the Fsharp.Data package.

This function takes in a list of HtmlNodes and matches on the name of the node, if it's a <p>-tag we turn that into a rich text paragraph. If it doesn't have a name we turn that into a text node. I then filled out the other supported types and a little method for parsing marks, which is attributes that decorate text in rich text lingo, for example, bold, italic, underline etc.

One glaring omission here is <img>-tags, which I haven't handled yet as I haven't fully decided on the strategy. Should the package help you create an asset or should it let you define your own callback for other custom tags you want to handle? I'll ponder this for the next version.

Contentful Markdown To Html Code

I then created the public functions that takes in the actual html string.

Note how I wrap the entire html in a rich text document-node in the htmlToJson function as this is a required root element in a Contentful rich text structure.

This package is now available as Contentful.RichTextParser on NuGet. I had plans to use the package in an Azure function to make it available for other languages as well, but currently the support for custom nuget packages in Azure Functions is abysmal, so that will have to wait. Anway, below is an example on how the package can be used in conjunction with the .NET SDK to parse HTML and pass it back in a rich text field to Contentful.

Contentful Markdown To Html Format

I hope you find it useful.