Files
oam/knowledge base/markdown.md
2023-03-25 20:33:56 +01:00

46 lines
1.3 KiB
Markdown

# Markdown
ReadMe's Markdown engine.
## Table of contents <!-- omit in toc -->
1. [Troubleshooting](#troubleshooting)
1. [Escape the backtick character](#escape-the-backtick-character)
1. [Further readings](#further-readings)
1. [Sources](#sources)
## Troubleshooting
### Escape the backtick character
Include a non-code formatted backtick by escaping it normally (with a `\`).
Render it in an inline code block using double backticks instead of single backticks.
Alternatively, use a code block. This will wrap everything in a `<pre>` HTML tag.
To do this, either indent 4 spaces to start a code block, or use fenced code blocks if supported.
## Further readings
- Official [documentation]
- [Linguist supported language syntax list]
## Sources
All the references in the [further readings] section, plus the following:
- [Escaping Backticks]
- [Escaping backtick in Markdown]
<!-- project's references -->
<!-- internal references -->
[documentation]: https://docs.readme.com/rdmd/docs
<!-- external references -->
[escaping backtick in markdown]: https://www.growingwiththeweb.com/2015/06/escaping-backtick-in-markdown.html
[escaping backticks]: https://www.markdownguide.org/basic-syntax/#escaping-backticks
[linguist supported language syntax list]: https://github.com/github/linguist/blob/master/lib/linguist/languages.yml