صفحة ماركداون

What is Markdown?

Markdown is a lightweight markup language that you can use to format plain text documents.
Write docs for your GitHub projects, edit your GitHub profile README etc. You fill find it all here.

Let’s dive into it. ⤵️

Table of Contents

  1. Paragraph
  2. Headings
  3. Emphasis
  4. Blockquote
  5. Images
  6. Links
  7. Code
  8. Lists
  9. Table
  10. Task List
  11. Footnote
  12. Jump to section
  13. Horizontal Line
  14. HTML

Paragraph

By writing regular text you are basically writing a paragraph.

This is a paragraph.

This is a paragraph.

Headings

There are 6 heading variants. The number of ”#” symbols, followed by text, indicates the importance of the heading.

# Heading 1
## Heading 2
### Heading 3
#### Heading 4
##### Heading 5
###### Heading 6

Heading 1

Heading 2

Heading 3

Heading 4

Heading 5
Heading 6

Emphasis

Modifying text is so neat and easy. You can make your text bold, italic and strikethrough.

Using two asterisks **this text is bold**.
Two underscores __work as well__.
Let's make it *italic now*.
You guessed it, _one underscore is also enough_.
Can we combine **_both of that_?** Absolutely.
What if I want to ~~strikethrough~~?

Using two asterisks this text is bold.
Two underscores work as well.
Let’s make it italic now.
You guessed it, one underscore is also enough.
Can we combine both of that? Absolutely.
What if I want to strikethrough?

Blockquote

Want to emphasise importance of the text? Say no more.

> This is a blockquote.
> Want to write on a new line with space between?
>
> > And nested? No problem at all.
> >
> > > PS. you can **style** your text _as you want_.

This is a blockquote. Want to write on a new line with space between?

And nested? No problem at all.

PS. you can style your text as you want. :

Images

The best way is to simply drag & drop image from your computer directly. You can also create reference to image and assign it that way.
Here is the syntax.

![text if the image fails to load](auto-generated-path-to-file-when-you-upload-image "Text displayed on hover")

[logo]: auto-generated-path-to-file-when-you-upload-image "Hover me"
![error text][logo]

text if the image fails to load

error text

Similar to images, links can also be inserted directly or by creating a reference. You can create both inline and block links.

[markdown-cheatsheet]: https://github.com/im-luka/markdown-cheatsheet
[docs]: https://github.com/adam-p/markdown-here

[Like it so far? Follow me on GitHub](https://github.com/im-luka)
[My Markdown Cheatsheet - star it if you like it][markdown-cheatsheet]
Find some great docs [here][docs]

Like it so far? Follow me on GitHub
My Markdown Cheatsheet - star it if you like it
Find some great docs here

Code

You can cerate both inline and full block code snippets. You can also define programming language you were using in your snippet. All by using backticks.

    I created `.env` file at the root.
    Backticks inside backticks? `` `No problem.` ``

    ```
    {
      learning: "Markdown",
      showing: "block code snippet"
    }
    ```

    ```js
    const x = "Block code snippet in JS";
    console.log(x);
    ```

I created .env file at the root. Backticks inside backticks? `No problem.`

{
  learning: "Markdown",
  showing: "block code snippet"
}
const x = 'Block code snippet in JS';
console.log(x);

Lists

As you can do in HTML, Markdown allows creating of both ordered and unordered lists.

Ordered List

1. HTML
2. CSS
3. Javascript
4. React
7. I'm Frontend Dev now 👨🏼‍🎨
  1. HTML
  2. CSS
  3. Javascript
  4. React
  5. I’m Frontend Dev now 👨🏼‍🎨

Unordered List

- Node.js
+ Express
* Nest.js
- Learning Backend ⌛️
  • Node.js
  • Express
  • Nest.js
  • Learning Backend ⌛️

Mixed List

You can also mix both of the lists and create sublists.
PS. Try not to create lists deeper than two levels. It is the best practice.

1. Learn Basics
   1. HTML
   2. CSS
   7. Javascript
2. Learn One Framework
   - React
     - Router
     - Redux
   * Vue
   + Svelte
  1. Learn Basics
    1. HTML
    2. CSS
    3. Javascript
  2. Learn One Framework
    • React
      • Router
      • Redux
    • Vue
    • Svelte

Table

Great way to display well-arranged data. Use ”|” symbol to separate columns and ”:” symbol to align row content.

| Left Align (default) | Center Align | Right Align |
| :------------------- | :----------: | ----------: |
| React.js             | Node.js      | MySQL       |
| Next.js              | Express      | MongoDB     |
| Vue.js               | Nest.js      | Redis       |
Left Align (default)Center AlignRight Align
React.jsNode.jsMySQL
Next.jsExpressMongoDB
Vue.jsNest.jsRedis

Task List

Keeping track of the tasks that are done, and those that need to be done.

- [x] Learn Markdown
- [ ] Learn Frontend Development
- [ ] Learn Full Stack Development
  • Learn Markdown
  • Learn Frontend Development
  • Learn Full Stack Development

Footnote

Want to describe something at the end of the file? Use footnote!

#### I am working on a new project. [^1]
[^1]: Stack is: React, Typescript, Tailwind CSS

Project is about music & movies.

##### Hope you will like it. [^see]
[^see]: Loading... ⌛️

I am working on a new project. 1

Project is about music & movies.

Hope you will like it. 2

Jump to section

Astro (and most Markdown parsers) automatically generates IDs for your headers. You usually don’t need to create manual <a name="..."> tags.

Horizontal Line

You can use asterisks, hyphens or underlines (*, -, _) to create horizontal line.
The only rule is that you must include at least three chars of the symbol.

First Horizontal Line

***

Second One

-----

Third

_________

First Horizontal Line

Second One

Third

HTML

You can also use raw HTML in your Markdown file. Most of the times that will work well, but sometimes you can experience some differences that you are not used to when working with standard HTML. Using CSS will not work.

<h1>This is a heading</h1>
<p>Paragraph...</p>

<hr />

<img src="auto-generated-path-to-file-when-you-upload-image" width="200">
<a href="https://github.com/im-luka">Follow me on GitHub</a>

<br />
<br />

<p>Quick hack for <strong><em>centering image</em></strong>?</p>
<p align="center"><img src="auto-generated-path-to-file-when-you-upload-image" /></p>

<details>
  <summary>One more quick hack? 🎭</summary>

  → Easy
  → And simple
</details>

This is a heading

Paragraph...

Follow me on GitHub

Quick hack for centering image?

One more quick hack? 🎭

→ Easy
→ And simple

Mermaid Diagrams

Mindmap

mindmap
  root((Test Intelligence Hub))
    Data Acquisition
      API Integration
      Browser Automation
      RSS Feeds
      Scheduling & Orchestration
    Data Processing
      Structured Data Storage
      Unstructured Data Processing
      LLM Integration
      Matching & Scoring
    Human Interface
      Dashboard & Visualization
      Alert Management
      Configuration & Settings
    Infrastructure
      Monitoring & Logging
      Error Handling
      Scalability
      Cost Efficiency

Flowchart

flowchart LR
    A[Data Sources] --> B[Ingestion Layer]
    B --> C[Processing Layer]
    C --> D[Storage Layer]
    D --> E[Human Interface]
    D --> F[LLM Interface]
    G[Monitoring Layer] -.-> B
    G -.-> C
    G -.-> D
Section with some ID

Footnotes

  1. Stack is: React, Typescript, Tailwind CSS ↩

  2. Loading… ⌛️ ↩