返回博客
标签: #markdown #productivity #writing

Markdown 语法的 80/20:掌握真正重要的部分

你无需死记硬背所有 Markdown 规则。掌握这 20% 的语法,就能覆盖 80% 的真实写作场景。

Markdown 是什么(用一段话说明)

Markdown 是一种轻量级的纯文本标记方式,可以把纯文本转换成干净的 HTML(或 PDF、文档、网站)。你用很简单的符号——比如标题用 #、列表用 -——就能写出结构化内容,同时文件仍然是你掌控的 .md 文本。


Markdown 语法的 80/20

记住下面这一小撮模式,你就毕业了:

标题

# Title
## Section
### Subsection

强调

**bold**   // 双星号
*italic*   // 单星号

列表

- item
- another item
  - nested item
1. first
2. second

链接与图片

[link text](https://example.com)
![alt text](path-or-url-to-image.jpg)

代码与引用

`inline code`
# fenced code block
```
print("hello")
```
> Blockquote for notes, callouts, or quoted text.

### 水平分割线
---

小技巧:标题就是“井号 + 空格”,列表是“短横 + 空格”。记住这两个,你已经覆盖了 80% 的写作需求。


10 分钟练习流程

按照这个流程做一遍,自然就有肌肉记忆。

  1. 创建一份新笔记,加上标题:# My First Markdown Note
  2. 写一个简短开头,带粗体和斜体:I’m learning *Markdown* the **easy way**.
  3. 做一份任务清单- [ ] Install a Markdown editor - [ ] Write a quick outline - [ ] Export as .md
  4. 插入代码块:输入 \“bash,换行后写上 mkdir notes && cd notesecho “Hello” > hello.md,最后用 ```` 收尾。
  5. 插入链接和图片Read more at [CommonMark](https://commonmark.org) ![A helpful diagram](./diagram.png)
  6. 用水平线和引用收尾:输入 --- 换行,再写 > Writing improves when formatting gets out of the way.

现在你已经把所有 80/20 语法都练了一遍。


常见错误(以及快速修正)

  • 标题后忘了空格##Heading ❌ → ## Heading
  • 列表后忘了空格-item ❌ → - item
  • 奇怪的换行 有些渲染器需要在区块之间(例如列表后)空一行,才能正确分段。
  • 围栏代码块没关闭 开头用三个反引号,结尾也要三个,别混用反引号和引号。
  • 图片不显示 重新检查路径。如果图片在子文件夹,用 ./images/pic.jpg 并确认文件真的存在。

.md 文件、备份与可移植性

你的笔记就是带 .md 扩展名的纯文本。这很好,因为:

  • 可移植: 任何编辑器都能打开(VS Code、Obsidian、Mdit 等)。
  • 易于比对: 想要历史版本时,可以用 Git 跟踪变化。
  • 面向未来: 纯文本不会被平台锁定。

在 Mdit 中,笔记会以 .md 文件直接保存到你的文件夹(iCloud / Google Drive / Dropbox 或本地目录)。你自己选择工作区,文件永远属于你。


入门模板

会议笔记

# Meeting: {Topic}
**Date:** {YYYY-MM-DD}  
**Attendees:** {Names}

## Agenda
- 

## Notes
- 

## Decisions
- 

## Action Items
- [ ] Owner – Task (Due)

日志(Daily Log)

# {YYYY-MM-DD}
## Top 3
1. 
2. 
3. 

## Notes
- 

## Wins
- 

项目 README

# {Project Name}
{One-sentence description.}

## Setup
# commands here

## Usage
- 

## Roadmap
- [ ] Milestone 1
- [ ] Milestone 2

试试 Mdit(免费,本地优先)

如果你喜欢这种“无需记忆”的方式,Mdit 能提供:

  • 快速插入模块的斜杠命令体验
  • 小于 10 MB 的干净、无干扰编辑器
  • 本地优先的存储方式,直接生成 .md 文件(文件都在你手里)

几分钟就能开始写作——无需繁琐配置,也不会被任何平台锁住。

返回首页