In this episode, we implement a minimal subset of Markdown in Elixir by chaining together regex replace functions into a processing pipeline. If you've ever written a static page on Github or a comment on Reddit, then you've used Markdown. Here's a quick overview in case you're not familiar with it.
Markdown is a terse, human-readable document format that is easily converted to HTML. Anything that appears between a pair of asterisks is *italicized*, while text between a pair of asterisks is **bolded**. A line starting with # creates an H1 tag while starting with ## creates an H2 tag, etc, etc. Markdown is pretty handy when you just want to write a document quickly.
The plan
-
Create a new module with a
to_html function that converts Markdown to HTML by calling a pipeline of other functions
-
Create an
italics function that will take a text input and use Regex.replace to globally replace *text* with <em>text</em> and return the new text.
-
Create a similar
bold function that will globally replace **text** with <strong>text</strong>
-
Create a
p function that wraps lines of text with <p> tags
-
Create a test string that uses various features and lets us easily test our module as we add to it.
-
Try writing an output.html file from a simple markdown file.
This module isn't that complex, but it's a great way to show off the power of Elixir's function pipelines! We'll go into a more standard way of doing unit tests once we start working with mix in a few lessons.
Challenge 5
Add two more HTML tags to markdown—"big" and "small". Decide for yourself what the syntax should be to generate them.
(solution here)
