Markdown is deceptively simple. Most writers learn the basics — headings, bold, italics, links — and stop there. But markdown has powerful features that can transform your writing workflow. Here are 10 tips that will level up your markdown game.
1 Tables Don't Have to Be Painful
Many writers avoid markdown tables because they think the syntax is tedious. The trick is to not worry about alignment — most parsers don't require it.
|---|---|---|
| WYSIWYG | Yes | Yes |
| Themes | 1 | 4 |
| Focus Mode | No | Yes |
Pro tip: In BluePad's WYSIWYG mode, tables are rendered with a visual editor — you can add rows and columns without touching the syntax.
2 Use Fenced Code Blocks with Language Tags
Always specify the language after your opening triple backticks. This enables syntax highlighting in most editors and renderers.
const greeting = "Hello, markdown!";
console.log(greeting);
```
BluePad supports syntax highlighting for over 150 languages in both WYSIWYG and source mode.
3 Task Lists for Quick TODOs
Turn any list into an interactive checklist with [ ] and [x] syntax:
- [x] Add code examples
- [ ] Proofread
- [ ] Publish
In BluePad, checkboxes are clickable in WYSIWYG mode — perfect for managing writing tasks.
4 Blockquotes for Callouts
Use blockquotes to highlight important information or create callout boxes:
> draws the reader's attention to key information.
You can nest blockquotes with multiple > characters for hierarchical quotes.
5 Horizontal Rules as Section Dividers
Three hyphens, asterisks, or underscores create a clean section break:
Content here...
---
## Section Two
More content...
6 Math Equations with KaTeX
For academic writing or technical documentation, inline and block math notation is invaluable:
Block:
$$
\frac{-b \pm \sqrt{b^2 - 4ac}}{2a}
$$
BluePad Pro renders KaTeX equations in real-time as you type — no need to preview separately.
7 Mermaid Diagrams from Text
Create flowcharts, sequence diagrams, and more without any drawing tool:
graph TD
A[Start Writing] --> B{Good idea?}
B -->|Yes| C[Draft]
B -->|No| D[Brainstorm]
D --> B
C --> E[Publish]
```
BluePad Pro renders Mermaid diagrams inline, making it easy to visualize workflows while you write.
8 Link References for Clean Documents
Instead of cluttering your text with long URLs, use reference-style links:
[install]: https://example.com/docs/install
[faq]: https://example.com/docs/faq
This keeps your source readable while maintaining all your links at the bottom.
9 Footnotes for Academic Writing
Add footnotes to provide additional context without interrupting the flow:
[^1]: John Gruber is also known for his blog, Daring Fireball.
Footnotes are automatically numbered and linked — readers can jump between the reference and the note.
10 Escape Characters When Needed
When you actually want to display markdown characters literally, use a backslash:
\# This is not a heading
\- This is not a list item
This is particularly useful when writing documentation about markdown itself.
Practice Makes Perfect
The best way to master these tips is to use them regularly in a proper markdown editor. BluePad's WYSIWYG mode lets you see the rendered output instantly, making it easier to learn and experiment with advanced syntax.
Whether you're writing documentation, blog posts, or personal notes, these ten techniques will make your markdown documents more professional and easier to read.