Madusha's Knowledge Vault

A lightweight markup language for writing formatted text in plain files. You write readable syntax like **bold** or # Heading, and a renderer turns it into HTML. The source stays legible on its own, which is why notes, READMEs, and chat apps lean on it. This whole vault is Markdown.

There is no single spec. CommonMark is the strict baseline; most tools layer extensions on top (GFM - GitHub Flavored Markdown, Octarine, etc.).

Basics

# H1   ## H2   ### H3        Headings, one to six #

*italic*  _italic_           Emphasis
**bold**  __bold__           Strong
***both***                   Bold + italic
~~strikethrough~~            GFM

`inline code`                Code span

> Blockquote                 Quote, nest with >>

---                          Horizontal rule (also *** or ___)

Hard line break: end a line with two trailing spaces, or a backslash ``. A blank line starts a new paragraph.

Lists

- Unordered          (also * or +)
  - Nested two spaces

1. Ordered
2. Numbers need not be sequential; the renderer fixes them

- [ ] Open task      GFM checkboxes
- [x] Done task

Links and images

[label](https://example.com)
[label](https://example.com "hover title")
![alt text](path/to/image.png)

[ref-style][1]                Reference links
[1]: https://example.com

<https://example.com>         Autolink

Code blocks

Fence with three backticks and an optional language for highlighting:

```js
const x = 1


To show literal backticks or a fence inside a fence, wrap the outer block in one more backtick (four).

# Tables (GFM)

```markdown
| Left | Center | Right |
|:-----|:------:|------:|
| a    |   b    |     c |

The colons in the divider row set column alignment. Cells do not need to line up in the source; the renderer handles it.

Escaping

Put a backslash before a character to render it literally: *not italic*. Inside a code span or block, nothing is interpreted.

Frontmatter

A YAML block fenced by --- at the very top of the file, used for metadata. Octarine reads title, publish, pinned, locked:

---
title: Markdown
publish: false
---