2. 使用markdown

2.1. 基本语法

你好,sphinx!这是使用markdown语法写的文件。

这里面有段落,有加粗,有斜体,有code
还有一个指向sphinx的链接。 当然,也可以有一个https://google.com直链接。


总的来说,md语法在写作时显得过于简单,无法对细节进行调整。

2.2. 列表

使用 Markdown 的优点:

  1. 专注你的文字内容而不是排版样式,安心写作。

  2. 轻松的导出 HTML、PDF 和本身的 .md 文件。

  3. 纯文本内容,兼容所有的文本编辑器与字处理软件。

  4. 随时修改你的文章版本,不必像字处理软件生成若干文件版本导致混乱。

  5. 可读、直观、学习成本低。

2.3. 图片

使用markdown语法插入图片无法调整图片大小,无法对图片进行说明。 logo

2.4. 代码

print("hello world!")