Markdown is a lightweight markup language that allows you to create well-structured content using plain text formatting. This project supports a variety of Markdown tags to help you create content that’s consistent and visually organized.

If you're using a Markdown editor like Obsidian, you can apply most tags by simply typing in plain text, then right-clicking to choose the appropriate tag.

1. Headings

Organize content with clear heading levels. Use # for different heading levels, ranging from # H1 to ###### H6.

Heading 1

Heading 2

Heading 3

Heading 4

Heading 5
Heading 6

2. Lists

Use both ordered and unordered lists.

  1. For ordered list, type a number, then a full stop, and then a space.
  • For unordered list - also known as bullet points - type a star (*) or a hyphen (-) or a plus (+) and then a space.

And for nested lists, just create your desired list and hit enter then tab. For eg;

  • This is a bullet point, you can do the same for numbered lists.
    • This is a nested bullet point
      • Again nested. Just hit enter and then tab.

3. Emphasis

Emphasize keywords or important sections of text.

  • Bold: Use **text** for bold.
  • Italic: Use *text* for italic.
  • Underline: Use <u>u tag</u> to achieve underlining.
  • Strikethrough: Use double tilde ~~ before and after a text.
  • Bold and italic: Use ***text*** for bold and italic
  • Mark: Use <mark>text</mark> for marking the text like this.`
  • Superscript: To create superscript text, use the <sup> tag. eg, E = mc2 (E = mc<sup>2</sup>). You can mainly use it for giving footnotes.
  • Subscript: For subscript text, use the <sub> tag. H2O (H<sub>2</sub>O)
  • Inlince code: Use the symbol called **backtick** for inline code, it looks like this (`)
  • Horizontal line: Either type --- or ***

4. Blockquotes

Highlight key points or quotes including citation.

Murphy's law doesn't mean that something bad will happen. It means that whatever can happen, will happen. And that sounded just fine to us. - Cooper | Interstellar (2014)

  • Use > before a paragraph to create a blockquote.
  • And to add a citation, use <cite>Citation text</cite>

5. Links

Easily add hyperlinks and reference links. The syntax is a combination of closed and open brackets.

[Link text](https://www.domain.com)

6. Buttons

Sometimes we need buttons. I have created two types of buttons. One as the default button and one as the primary button. Check the below code snippets.

<button onclick="window.open('https://www.domain.com', '_blank', 'noopener');">
	Default button
</button>

See how simple it is... Just copy paste this code snippet, change the link and the button label.

6.1 Alerts
This is an info alert!
This is a success alert!
This is a warning alert!
This is a danger alert!

7. Media

7.1 Images

Use the HTML <img> tag to embed images. Just copy the code below, update the image path, and write a short alt text. html Copy Edit

<img src="https://www.domain.com/assets/media/images/image.avif" alt="describe the image">
Obsidian is the best markdown editor
7.2 Video

For video use the below code snippet. Call raw links from external libraries, which means the url ends with the video extension and if you run that url on browser, it will play a video using browser video player.

<video controls>
    <source src="https://github.com/romiojoseph/blogspot/raw/refs/heads/main/blog/media/videos/video.mp4" type="video/mp4">
    Your browser does not support the video tag.
</video>
7.3 Audio

For video use the below code snippet. The same rule applies here.

<audio controls>
    <source src="https://github.com/romiojoseph/blogspot/raw/refs/heads/main/blog/media/audios/audio.mp3" type="audio/mpeg">
    Your browser does not support the audio element.
</audio>

8. Code snippet

For code snippets, right-click, format and select the 'Code' option. Alternatively, surround the code with triple backticks for a block code format.

If it shows   in the code block, just select the affected text, Shit + Tab and bring everything to the first column and then use tab to properly indent.

code {
	font-family: var(--font-family-mono);
	font-size: var(--font-size-body);
	font-weight: 400;
	padding: 0;
	margin: 0;
	color: var(--obsidian-11);
	line-height: 1.6;
	word-wrap: break-word;
	white-space: pre-wrap;
}

9. Embed

You can easily embed Bluesky posts, YouTube videos, Spotify songs and more. Just grab the code from the respective posts/videos/songs and just paste it here.

Bluesky

This is how Bluesky is decentralized. In the same way that you can switch search engines and see the same web, you can switch social apps and see the same atmosphere.

It's because everybody's got their own site

— Paul Frazee (@pfrazee.com) October 21, 2024 at 2:56 AM

YouTube

To embed a YouTube video use this iframe code snippet. You can grab the embed link source from YouTube. And copy and replace that link only here (make sure it's an embed link - for eg; https://www.youtube.com/embed/F_pInoR8Dcs). So that the styles will be maintained.

<iframe 
	class="youtube-embed"
    src="https://www.youtube.com/embed/F_pInoR8Dcs" 
    title="YouTube video player" 
    frameborder="0" 
    allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" 
    referrerpolicy="strict-origin-when-cross-origin" 
    allowfullscreen>
</iframe>

10. Table

To be frank, table formatting in markdowns is a little difficult. But we have Obsidian, right? So just right click > Insert > Table.

You can create great tables easily and there is also sort option which means you can build the table easily first and manage it later with features like add, move, duplicate, delete, align and sort.

Less column table

Data credits: Perplexity

Technology Description Creator
C (1972) Foundational general-purpose programming language Dennis Ritchie (Bell Labs)
C++ (1985) Object-oriented extension of C Bjarne Stroustrup (Bell Labs)
ARPANET (1969) First operational packet-switching network U.S. Department of Defense
TCP/IP (1983) Internet protocol suite for reliable data transfer Vint Cerf, Bob Kahn
HTML 1.0 (1993) Standardized markup language for the web Tim Berners-Lee (W3C)
Java (1995) Platform-independent, object-oriented language James Gosling (Sun Microsystems)
JavaScript (1995) Language for client-side scripting in browsers Brendan Eich (Netscape)
Ruby (1995) High-level, interpreted programming language Yukihiro Matsumoto
CSS 1.0 (1996) Styling language for HTML Håkon Wium Lie (W3C)
XML 1.0 (1998) Markup language for data storage and transport World Wide Web Consortium (W3C)
RSS 0.9 (1999) Initial version of RSS for web syndication Ramanathan V. Guha (Netscape)
AJAX (2005) Asynchronous JavaScript and XML for dynamic web pages Jesse James Garrett (Adaptive Path)
Atom 1.0 (2005) Syndication format alternative to RSS Internet Engineering Task Force (IETF)
Node.js (2009) JavaScript runtime for server-side programming Ryan Dahl
React (2013) JavaScript library for building user interfaces Jordan Walke (Facebook)
HTML5 (2014) Fifth major revision of HTML World Wide Web Consortium (W3C)
Kubernetes (2014) System for container orchestration Google
TensorFlow (2015) Open-source machine learning and deep learning library Google
AI (Deep Learning) (2010s) Advancements in deep learning and AI Developed by various organizations globally
A few column table

Data credits: Google

Movie Year Genre Director Music IMDb
The Godfather 1972 Drama Francis Ford Coppola Nino Rota https://www.imdb.com/title/tt0068646
The Dark Knight 2008 Action Christopher Nolan James Newton Howard and Hans Zimmer https://www.imdb.com/title/tt0468569/
The Descendants 2011 Drama Alexander Payne Jeff Peterson https://www.imdb.com/title/tt1033575/
Gravity 2013 Thriller Alfonso Cuarón Steven Price https://www.imdb.com/title/tt1454468/
Interstellar 2014 Sci-fi Christopher Nolan Hans Zimmer https://www.imdb.com/title/tt0816692/
More than a few column table

Data credits: Meta AI

TV Show Year Genre Creator Seasons Episodes Episode Length IMDb
Friends 1994 Comedy David Crane 10 236 22 min 8.9/10
The Office (US) 2005 Comedy Greg Daniels 9 201 22 min 8.8/10
How I Met Your Mother 2005 Comedy Craig Thomas 9 208 22 min 8.3/10
The Big Bang Theory 2007 Comedy Chuck Lorre 12 279 18-22 min 8.1/10
Breaking Bad 2008 Drama Vince Gilligan 5 62 45-60 min 9.5/10
Modern Family 2009 Comedy Christopher Lloyd 11 250 22 min 8.4/10
Young Sheldon 2017 Comedy Chuck Lorre 6 127 18-22 min 7.8/10