测试文章
Markdown 常见格式示例文章
本文以一篇常规文章的结构,展示 Markdown 中常见的排版格式,包括标题、段落、强调、列表、引用、链接、图片、代码、表格和脚注等。
一、什么是 Markdown?
Markdown 是一种轻量级标记语言。它允许用户使用简单的符号编写结构清晰的文本,并将其转换为 HTML、PDF 或其他文档格式。 与传统的富文本编辑器相比,Markdown 具有以下特点:
- 语法简单,容易学习
- 纯文本格式,便于版本管理
- 可在不同平台之间迁移
- 适合编写文档、博客、笔记和项目说明
二、文字格式
Markdown 支持多种文字强调方式。
普通文字保持原样。
这是粗体文字。
这是斜体文字。
这是粗斜体文字。
~~这是删除线文字。~~
这是一个包含行内代码的句子。
在部分 Markdown 编辑器中,还可以使用 HTML 实现其他效果,例如:
<u>这是带下划线的文字。</u>
H<sub>2</sub>O 表示水,2<sup>10</sup> 等于 1024。
如果需要显示 Markdown 特殊符号,可以使用反斜杠进行转义:
\这段文字不会显示为斜体\
三、不同级别的标题
Markdown 一般支持六级标题:
一级标题
二级标题
三级标题
四级标题
五级标题
六级标题
实际写作中,建议从一级标题开始,并按照文章层级依次使用标题,避免跳级。
四、引用内容
引用适合用于展示他人的观点、书籍内容或需要特别强调的信息。
写作不是把文字堆积起来,而是将思想组织成清晰的结构。 引用还可以包含多个段落: Markdown 的价值不只在于语法简单。 它还能够帮助作者专注于内容本身。 引用可以嵌套: 第一层引用 > 第二层引用 > 第三层引用
五、列表
5.1 无序列表
无序列表可以使用减号、加号或星号:
- 第一项内容
- 第二项内容
- 第三项内容 嵌套列表需要缩进:
- 前端开发
- HTML
- CSS
- JavaScript
- 后端开发
- Python
- Java
- Go
5.2 有序列表
- 确定文章主题
- 整理文章结构
- 编写正文内容
- 检查并修改
- 发布文章 嵌套有序列表:
- 准备阶段
- 收集资料
- 明确目标
- 写作阶段
- 编写初稿
- 调整结构
- 完成阶段
- 校对内容
- 导出文档
5.3 任务列表
任务列表常用于项目计划和待办事项:
- [x] 确定文章标题
- [x] 完成文章大纲
- [ ] 补充示例图片
- [ ] 检查链接是否有效
- [ ] 发布最终版本
六、链接
这是一个普通链接:Markdown 官方语法说明 这是一个带提示文字的链接: 访问示例网站 也可以直接显示网址: https://example.com 或者使用引用式链接,让正文更加整洁: 你可以访问示例网站查看更多内容。 文章内部还可以使用锚点链接: 返回文章顶部
七、图片
图片语法与链接类似,只是在前面增加一个感叹号:
也可以使用引用式图片:
图片能否正常显示,取决于图片地址是否有效以及当前编辑器是否允许加载外部资源。
八、代码
8.1 行内代码
可以使用反引号标记变量名、命令或文件名,例如:
请运行 npm install 安装依赖,然后打开 package.json 文件。
8.2 多行代码块
使用三个反引号创建代码块,并在开头指定编程语言。
def greet(name: str) -> str:
"""返回一条问候语。"""
return f"你好,{name}!"
print(greet("Markdown"))
JavaScript 示例:
const users = ["张三", "李四", "王五"];
users.forEach((user, index) => {
console.log(`${index + 1}. ${user}`);
});
Shell 命令示例:
git add .
git commit -m "docs: 添加 Markdown 示例"
git push origin main
8.3 缩进代码块
将内容缩进四个空格,也可以创建代码块:
function add(a, b) {
return a + b;
}
九、表格
表格适合展示结构化数据: