diff --git a/.eleventy.js b/.eleventy.js
index c46dfb7..7127465 100644
--- a/.eleventy.js
+++ b/.eleventy.js
@@ -95,6 +95,7 @@ module.exports = function (eleventyConfig) {
     eleventyConfig.ignores.add("src/_data/**");
     eleventyConfig.ignores.add("src/_includes/**");
     eleventyConfig.ignores.add("src/assets/**");
+    eleventyConfig.ignores.add("docs");
     eleventyConfig.ignores.add("src/i18n/**");
     eleventyConfig.ignores.add("scripts/**");
 
diff --git a/README.md b/README.md
index f0984e4..a2c346c 100644
--- a/README.md
+++ b/README.md
@@ -50,6 +50,15 @@ BLEU-Website/
 - **[GitHub Actions](https://github.com/features/actions)** - CI/CD
 - **[GitHub Pages](https://pages.github.com/)** - Hosting
 
+---
+
+## Markdown Feature Support
+
+We support a rich set of Markdown features for writing blog posts.
+
+👉 **Full documentation:** [Markdown Guide](./docs/markdown.md)
+
+---
 ## License
 
 MIT © BLEU Community
diff --git a/docs/markdown.md b/docs/markdown.md
new file mode 100644
index 0000000..c030cbc
--- /dev/null
+++ b/docs/markdown.md
@@ -0,0 +1,194 @@
+# Markdown Feature Support
+
+This documentation outlines the Markdown features supported by the BLEU Community Blog. Each feature includes the proper syntax and examples for clarity.
+
+---
+
+## Headings
+
+Create headings using the hash (`#`) symbol followed by a space. The number of hashes determines the level.
+
+```md
+# Heading 1
+## Heading 2
+### Heading 3
+#### Heading 4
+```
+
+---
+
+## Emphasis
+
+You can add emphasis using asterisks (`*`) or underscores (`_`).
+
+### Bold
+
+Wrap text with two asterisks or two underscores.
+
+```md
+**This is bold text** __This is also bold text__
+```
+
+### Italic
+
+Wrap text with one asterisk or one underscore.
+
+```md
+*This is italic text* _This is also italic text_
+```
+
+### Bold and Italic
+
+Wrap text with three asterisks or three underscores.
+
+```md
+***This is bold and italic text*** ___This is also bold and italic text___
+```
+
+---
+
+## Blockquotes
+
+Create blockquotes by prefixing lines with a greater-than symbol.
+
+```md
+> This is a blockquote.
+> It can span multiple lines if you prefix each line.
+```
+
+---
+
+## Lists
+
+### Unordered Lists
+
+Use `-`, `*`, or `+`.
+
+```md
+- Item one
+- Item two
+  - Nested item
+```
+
+### Ordered Lists
+
+Use numbers followed by a period.
+
+```md
+1. First item
+2. Second item
+   1. Nested ordered item
+```
+
+---
+
+## Code Blocks
+
+### 1. Standard Markdown Syntax
+
+Use three ``` backticks and specify the language name:
+
+
+![A descriptive alt text](/src/assets/images/code-3.png)
+
+
+
+### 2. Nunjucks Syntax
+
+```njk
+{% highlight js %}
+console.log("Hello from Nunjucks!");
+{% endhighlight %}
+````
+
+### Supported Languages
+
+| Tag to Type | Displayed Label |
+| ----------- | --------------- |
+| js          | JS              |
+| ts          | TS              |
+| html        | HTML            |
+| css         | CSS             |
+| json        | JSON            |
+| python      | Python          |
+| php         | PHP             |
+| bash        | Bash            |
+| sql         | SQL             |
+| java        | JAVA            |
+| rust        | RUST            |
+| cpp         | C++             |
+| c           | C               |
+| csharp      | C#              |
+| diff        | DIFF            |
+| example     | example         |
+
+---
+
+## Horizontal Rule
+
+Create a horizontal rule using three or more hyphens:
+
+```md
+---
+```
+
+---
+
+## Links
+
+```md
+[Visit our homepage](https://example.com/)
+```
+
+---
+
+## Images
+
+```md
+![A descriptive alt text](/images/code.png)
+```
+
+---
+
+## Escaping Characters
+
+Prefix characters with a backslash `\` to prevent formatting.
+
+| Character | Name             |
+| --------- | ---------------- |
+| \         | backslash        |
+| `         | backtick         |
+| *         | asterisk         |
+| _         | underscore       |
+| { }       | curly braces     |
+| [ ]       | brackets         |
+| < >       | angle brackets   |
+| ( )       | parentheses      |
+| #         | pound sign       |
+| +         | plus sign        |
+| -         | minus sign       |
+| .         | dot              |
+| !         | exclamation mark |
+| |         | pipe             |
+
+---
+
+## Tables
+
+### Standard Table
+
+```md
+| Header 1 | Header 2 | Header 3 |
+|----------|----------|----------|
+| Cell 1   | Cell 2   | Cell 3   |
+| Cell 4   | Cell 5   | Cell 6   |
+```
+
+### Table with Alignment
+
+```md
+| Left Aligned | Center Aligned | Right Aligned |
+|:-------------|:--------------:|---------------:|
+| Left text    | Center text    | Right text     |
+| Data         | Data           | Data           |
+```
diff --git a/src/assets/images/code-2.png b/src/assets/images/code-2.png
new file mode 100644
index 0000000..527e7db
Binary files /dev/null and b/src/assets/images/code-2.png differ
diff --git a/src/assets/images/code-3.png b/src/assets/images/code-3.png
new file mode 100644
index 0000000..d847f74
Binary files /dev/null and b/src/assets/images/code-3.png differ
diff --git a/src/assets/images/code.png b/src/assets/images/code.png
new file mode 100644
index 0000000..5406fa9
Binary files /dev/null and b/src/assets/images/code.png differ