sendnote.link
Blog
Back to blog
tutorials

Markdown Formatting Guide: Write Beautiful Notes

February 20, 20267 min read

What Is Markdown?

Markdown is a lightweight markup language created by John Gruber in 2004. It lets you add formatting to plain text using simple, intuitive symbols. Instead of clicking toolbar buttons or memorizing complex HTML tags, you write naturally using characters like #, *, and - to indicate structure and emphasis.

The beauty of markdown lies in its readability. Even without rendering, a markdown document is easy to read as plain text. Once rendered, it transforms into clean, structured HTML with proper headings, lists, links, and more.

Why Markdown Matters for Note Sharing

When you share a note with someone, presentation matters. A wall of unformatted text is hard to scan and easy to misunderstand. Markdown solves this by letting you structure your content clearly, without needing a word processor or rich text editor.

Markdown has become the standard for technical documentation, README files, forums, and collaborative writing. Tools like GitHub, Notion, Slack, and Discord all support some form of markdown. Learning it once means you can write formatted text almost anywhere.

On sendnote.link, your markdown notes are rendered beautifully with syntax highlighting, proper typography, and responsive layouts. Whether you are sharing a code snippet, a meeting agenda, or a set of instructions, markdown helps your content look professional and be easy to read.

Complete Guide to Markdown Syntax

Headings

Headings create structure and hierarchy. Use the # symbol followed by a space. More # symbols mean smaller, lower-level headings.

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

A good practice is to use a single # heading as the title of your note, then ## for major sections, and ### for subsections within those.

Bold and Italic Text

Emphasize words and phrases using asterisks or underscores.

**This text is bold**
*This text is italic*
***This text is bold and italic***

You can also use __underscores for bold__ and _underscores for italic_.

Use bold for important terms or warnings. Use italic for subtle emphasis, titles of works, or introducing new terms. Use bold italic sparingly for maximum emphasis.

Strikethrough

Strike through text that is no longer relevant or has been corrected.

~~This text is crossed out~~

This is useful when sharing notes that track changes or corrections without deleting the original text.

Lists

Markdown supports both ordered (numbered) and unordered (bulleted) lists.

Unordered lists use -, *, or + followed by a space:

- First item
- Second item
  - Nested item
  - Another nested item
- Third item

Ordered lists use numbers followed by a period:

1. First step
2. Second step
3. Third step
   1. Sub-step A
   2. Sub-step B

You can even mix list types by nesting an unordered list inside an ordered one, or vice versa. Indentation (two or three spaces) creates nested levels.

Create clickable hyperlinks with square brackets for the text and parentheses for the URL.

[Visit sendnote.link](https://sendnote.link)
[Send me an email](mailto:hello@example.com)

You can also create reference-style links for cleaner documents:

Check out [sendnote.link][1] for secure note sharing.

[1]: https://sendnote.link

Images

Images use the same syntax as links, but with an exclamation mark at the beginning.

![Alt text describing the image](https://example.com/image.png)

The alt text inside the square brackets describes the image for accessibility and displays when the image cannot load.

Code

Markdown handles both inline code and code blocks, making it ideal for sharing technical content.

Inline code uses single backticks:

Use the `console.log()` function to debug your code.

Code blocks use triple backticks. You can specify the programming language for syntax highlighting:

```javascript
function greet(name) {
  return `Hello, ${name}!`;
}

console.log(greet("World"));
```

On sendnote.link, code blocks are rendered with syntax highlighting powered by Shiki, supporting dozens of languages including JavaScript, Python, TypeScript, Rust, Go, SQL, and many more. The highlighting automatically adapts to light and dark themes.

Blockquotes

Use the > symbol to create blockquotes, which are perfect for quoting text, adding callouts, or highlighting important notes.

> This is a blockquote. It stands out from the rest of the text
> and draws attention to important information.

> You can also nest blockquotes:
>> This is a nested blockquote.

Tables

Create organized data tables using pipes | and hyphens -.

| Feature        | Free Plan | Pro Plan  |
|----------------|-----------|-----------|
| Notes per day  | 10        | Unlimited |
| Expiry options | 24 hours  | Custom    |
| Burn after read| Yes       | Yes       |

You can align columns using colons in the separator row:

| Left-aligned | Center-aligned | Right-aligned |
|:-------------|:--------------:|--------------:|
| Text         | Text           | Text          |

Horizontal Rules

Create a visual separator between sections using three or more hyphens, asterisks, or underscores.

---
***
___

Task Lists

Task lists are great for sharing checklists and to-do items.

- [x] Write the introduction
- [x] Add code examples
- [ ] Review and proofread
- [ ] Share with the team

When you create a note on sendnote.link and choose the markdown format, your content is rendered server-side into clean, styled HTML. Here is what makes the rendering stand out:

  • Syntax highlighting: Code blocks are highlighted using Shiki with dual-theme support. Your code looks great in both light and dark mode, with accurate coloring for dozens of programming languages.
  • GitHub Flavored Markdown: We support GFM extensions including tables, task lists, strikethrough, and autolinked URLs.
  • Typography: Notes are rendered with Inter for body text and JetBrains Mono for code, ensuring readability across devices.
  • Responsive design: Your notes look great on desktop, tablet, and mobile screens.

Tips for Effective Note Formatting

Keep Headings Hierarchical

Do not skip heading levels. Go from ## to ###, not from ## to ####. This creates a logical structure that is easy to scan and navigate.

Use Blank Lines Generously

Separate paragraphs, headings, and list items with blank lines. This improves readability in both raw markdown and rendered output.

Choose the Right Emphasis

Reserve bold for truly important terms and warnings. Overusing bold makes nothing stand out. Italic works well for softer emphasis or introducing terminology.

Break Up Long Content

Use headings, lists, and horizontal rules to break up long notes. A note that is one continuous paragraph is much harder to read than one with clear sections.

Preview Before Sharing

Always preview your markdown before sharing a note. What looks right in your head may render differently. sendnote.link shows you a live preview so you can catch formatting issues before generating a share link.

Use Code Blocks for Any Structured Data

Code blocks are not only for source code. Use them for terminal commands, configuration files, JSON data, log output, or any content where exact formatting matters.

```json
{
  "name": "sendnote.link",
  "purpose": "secure note sharing"
}

## Conclusion

Markdown is a skill that pays off everywhere you write online. With just a handful of symbols, you can transform plain text into structured, readable, professional-looking content. Whether you are sharing a quick code snippet, a detailed project brief, or a set of instructions with a colleague, markdown helps your message come through clearly.

On sendnote.link, your markdown notes get the full treatment: beautiful typography, syntax-highlighted code, and a clean reading experience for anyone you share with. Start writing your next note in markdown and see the difference it makes.

Ready to share a note?

Create and share notes instantly. No sign-up required.

Create a note