Markdown

Markdown uses punctuation-based syntax to format text, drawing inspiration from plain text email conventions. The goal is for Markdown documents to be easy to read. For concerns that the specification does not cover, users are free to use HTML. However, the HTML tags that rendering engines support vary considerably. Further, some rendering engines have their own approach to extensions, like shortcodes in Hugo. Generally, best practice is to avoid mixing Markdown and HTML, as doing so can detract from Markdown’s intended simplicity and readability. ...