常用技巧

这一页集中讲实际写作时最常遇到的问题。

进阶排版(常用技巧)

换行与缩进

段落之间空一行,是最稳的写法。不要靠连续空格做人肉排版。

第一段

第二段

普通 Markdown 不建议用大量空格做人肉缩进。需要层级时,优先用标题、列表、引用来表达结构。

特殊符号输入

像反引号、竖线、尖括号这类符号,最方便的方法就是直接从案例里复制。

`代码`
| 表格分隔 |
<HTML>

链接(普通 + 页内锚点 + 高级用法)

[OpenAI](https://openai.com)
[页内跳转](#line-breaks)
[OpenAI](https://openai.com "提示说明")

普通链接、页内锚点和带标题说明的链接,都可以放在这一类里理解。有些平台支持更多高级属性,但并不是所有渲染器都完整支持。

图片(插入、尺寸、对齐、标题)

![替代文字](image.png "图片标题")

标准 Markdown 只负责插入图片。尺寸、对齐和标题效果,通常依赖平台扩展或 HTML 能力。

自动目录 [TOC]

[TOC]

有些平台支持自动目录标记,但并不是所有 Markdown 渲染器都会生效。

文本对齐、字体颜色、字号、背景色

标准 Markdown 本身不负责文本对齐、字号、颜色和背景色,这类效果通常要依赖具体平台或 HTML 扩展能力。正式文档里建议少用,避免换平台后显示不一致。

折叠/展开区块

<details>
<summary>点击展开</summary>
这里是折叠内容
</details>

折叠区块通常依赖 HTML 扩展能力,适合放说明、补充信息和附注。

注释(隐藏内容)

<!-- 这是一段注释,不会显示在页面上 -->

注释适合给自己留提示,不会出现在最终展示内容里。

Emoji 表情符号

Emoji 可以直接输入,比如 😀📌。做文档时建议适量使用。