数字技能文档
Markdown 入门
从写一份清晰文档开始,体验文本、预览和版本管理。
Markdown 入门
Markdown 是一种用普通文本表示结构的写法。文件通常以 .md 结尾,可以在记事本、VS Code、GitHub 和许多笔记工具中打开。
先认识几个语法
# 一级标题
## 二级标题
- 列表项目
- 另一个项目
[链接文字](https://example.com)
**加粗文字**
`行内代码`
```js
console.log("Hello, World!");
```
标题的 # 后面要留一个空格。列表项使用 - 加空格。空一行可以清楚地分隔段落。
写一份最小 README
在一个练习文件夹中新建 README.md:
也可以下载课程 README 模板,另存一份后填写自己的目标与验证记录。
# 我的第一个项目
这是一个用来练习 Markdown 和 GitHub 的项目。
## 我完成了什么
- 运行 Hello World
- 使用命令行查看目录
- 写下这份说明
## 下一步
- 把文件保存到 GitHub
保存后使用编辑器的 Markdown 预览功能,检查标题、列表和代码块是否正确。
图片和相对路径

images/example.png 是相对当前文档的位置。移动图片或文档后,链接可能失效。文件名尽量使用清楚的英文、数字和短横线,避免在技术项目中混入难以处理的特殊字符。
Markdown 不负责什么
- 它不是 Word,不能保证每台设备上都有完全相同的分页和字体。
- 改成
.md后缀不会把 Word 文档自动转换成 Markdown。 - 预览正常不代表链接和事实正确,提交前仍要检查内容。
完成标准
- 创建一个
README.md。 - 使用标题、段落、列表、链接和代码块。
- 在预览中确认格式正常。
- 用命令行或文件资源管理器找到它的准确位置。
完成后进入 GitHub 基础,把这份 README 放进第一个仓库。