学生投稿 Markdown 完整写作指南

投稿指南2026-09-26 更新

这篇指南对应本站的投稿编辑器。你可以直接点击工具栏完成排版，也可以在左侧输入 Markdown 符号；右侧会显示效果。不必一次记住所有语法，写到哪一步就查哪一节。

最快上手：先填写投稿页上方的文章标题、昵称和类型，再在“Markdown 正文”左侧写内容。写完看右侧预览，点击“保存本机草稿”可以暂存到当前浏览器；确认无误后再提交审核。保存本机草稿不等于投稿成功。

一、先认识投稿编辑器

默认是左侧编辑、右侧预览。左侧保留 Markdown 原文，右侧显示排版后的效果。工具栏中的“标题、粗体、列表、链接、表格、上传”等按钮可以帮你插入对应语法；鼠标停在按钮上会显示名称。工具栏中的“编辑 & 预览”可以切换分栏，“预览”可以单独查看成品。

右侧预览上方的 Desktop、Tablet、Mobile/Wechat 只改变预览宽度，方便检查电脑、平板和手机上的阅读效果；后面的公众号与知乎按钮用于复制排版后的内容，不会直接发布。真正投稿仍要点击下方的“提交审核”。

如果暂时不想记语法，先用工具栏写一段，再观察左侧出现的符号。下面这张速查表是最常用的五种写法：

想做什么	输入示例	效果
小标题	`## 解题思路`	显示为章节标题
强调重点	`先判断边界`	先判断边界
列步骤	`- 读题`	生成项目列表
放网页链接	`[题目](https://...)`	显示可点击的“题目”
标记代码名	`vector`	把 `vector` 显示为行内代码

二、标题、段落与换行

标题怎么分层

在一行开头输入 #，后面留一个空格再写标题。井号越多，层级越低。投稿页上方已有独立的文章标题输入框，正文通常从 ## 小节开始即可，不必把文章标题重复写一遍。

可以复制到左侧试一试

## 题目思路
### 为什么想到这个方法
### 算法步骤

新段落与段内换行

想开始新段落，在两段之间留一个空行。只按一次 Enter，预览中可能仍属于同一段。想在同一段内部强制换行，可以在上一行末尾输入两个半角空格，再按 Enter；行尾空格看不见，写完要检查右侧预览。

空一行，形成两个段落

我先枚举每一种可能的选择。

然后比较它们的代价，保留最优答案。

第一行末尾有两个半角空格，形成段内换行

时间复杂度：O(n)  
空间复杂度：O(1)

需要明显分隔两个部分时，也可以单独写一行 ---。不要靠连续输入很多空格来排版；手机和电脑的宽度不同，空格很容易错位。

三、强调、列表、待办事项与引用

**文字** 是加粗，*文字* 是斜体，~~文字~~ 是删除线。强调一两处关键结论即可，整段加粗反而不好读。

**关键结论：**每个状态只需要计算一次。
这里的 *边界条件* 最容易漏掉。
~~先前的错误想法~~ 改成从左到右扫描。

步骤用无序列表或有序列表。符号后要留一个空格；在列表前后留空行，结构更稳定。子步骤可以缩进四个空格。待办事项可用 - [ ] 和 - [x]。

- 读题并写下输入、输出
- 检查样例
    - 手算最小情况
    - 手算最大情况
- 写代码并测试

1. 先枚举所有点
2. 再更新最短距离
3. 最后输出答案

- [x] 已经读懂题意
- [ ] 还要测试边界情况

引用题目中的一句话、提示或需要特别提醒的内容时，在行首加 >：

> 提醒：数组下标从 0 开始，不要访问到 n。

四、插入网页链接

链接的格式是 [显示给读者的文字](完整网址)。优先写清楚“点开后是什么”，不要只写“点这里”。网址一般以 https:// 开头。

原题：[洛谷 P1001：A+B Problem](https://www.luogu.com.cn/problem/P1001)
相关知识：[本站知识文档](https://你的网址/知识文档地址)

第一行是真实示例；第二行的“你的网址/知识文档地址”只是格式占位，使用时要换成实际网址。也可以选中文字后点击工具栏的“链接”按钮填写网址。先保存草稿，再从右侧预览检查链接是否指向正确页面。不要粘贴电脑上的 C:\ 路径或 file:// 地址，其他同学打不开。

五、插入图片和文件附件

图片：让读者直接看到

图片语法是在普通链接前多一个感叹号：![图片说明](图片网址)。“图片说明”应描述图片内容，例如“样例运行结果”，这样图片加载失败时读者也知道原本展示什么。

最方便的做法是在正式网站登录后，把光标放在需要插图的位置，点击编辑器工具栏的上传图标，选择本地图片。上传成功后，编辑器会自动插入图片语法和可访问的网址；不用手动拼接地址。最后检查右侧预览中的图片、大小和所在段落。

图片语法的结构示意，括号中的占位文字需要由真实图片地址替换

![样例运行结果](上传后自动生成的图片地址)

附件：给读者一个下载链接

PDF 讲义、源码或压缩包也使用同一个上传图标。上传成功后，编辑器会自动插入 [文件名](文件地址)；图片通常直接显示，其他附件显示为可点击的下载链接。建议在链接前补一句用途，例如“下面是完整测试数据”。

附件语法的结构示意，不需要手动输入地址

完整测试数据：[边界样例.zip](上传后自动生成的文件地址)

上传规则：需要登录并连接正式网站。支持 PNG、JPG/JPEG、GIF、WEBP 图片，以及 PDF、TXT、MD、CPP、H、HPP、PY、ZIP 附件；单个文件不超过 5 MB，账号上传总量不超过 100 MB。上传完成前不要提交文章。直接用 file:// 打开的本地预览页不能代替正式上传。

稿件审核通过且选择公开展示后，公开文章里引用的文件可以被读者打开。上传前请删除图片、PDF 或源码里可能包含的姓名、学校、联系方式、账号和密钥。

六、写行内代码和代码块

一句话里提到变量名、函数名或文件名时，用一对反引号包住，例如 `dist[i]`。一整段程序用上下各一行三个反引号围住；开头可以写 cpp、python 等语言名，方便阅读和高亮。

这里用 `dist[i]` 记录从起点到 i 的距离。

```cpp
#include <iostream>
using namespace std;

int main() {
    int a, b;
    cin >> a >> b;
    cout << a + b << '\n';
}
```

围栏上下的三个反引号都要写完整，并各占一行。代码块里写的是代码原样，里面的加粗、公式和链接不会继续按 Markdown 排版。很长的程序可以只展示关键部分，再上传完整源码作为附件。

七、制作表格

点击工具栏的“表格”按钮可以先生成骨架，再改文字。手写时，每行用竖线 | 分隔单元格；第二行的短横线用于标明表头，不能省略。

| 情况 | 输入 | 预期输出 |
| :--- | :---: | ---: |
| 最小值 | 1 | 1 |
| 一般值 | 5 | 15 |
| 最大值 | 100 | 5050 |

第二行的冒号控制对齐：:--- 左对齐，:---: 居中，---: 右对齐。每行的列数保持一致。若单元格内容里真的需要竖线，写成 \|，避免被当作下一列。表格适合整理测试样例、复杂度和方案比较；长段解释还是用普通段落更易读。

八、写数学公式

一句话中的短公式放在一对美元符号之间，例如 $O(n\log n)$ ；需要单独占一行的大公式，前后各写一行 $$。工具栏中的 ∑ 按钮会插入一个分式模板，替换模板中的字母即可。

行内公式

枚举一遍数组的时间复杂度是 $O(n)$，排序约为 $O(n\log n)$。

独立公式

前 n 个正整数的和：

$$
\sum_{i=1}^{n} i = \frac{n(n+1)}{2}
$$

常用写法	用途
`a^2`、`x_i`	上标、下标
`\frac{a}{b}`	分数
`\sum_{i=1}^{n} i`	求和及上下限
`\le`、`\ge`、`\times`	≤、≥、×

表中命令要放在 $...$ 或 $$...$$ 内才会显示为数学符号。若右侧仍显示原始美元符号，先检查两端是否配对、命令前的反斜杠是否漏写，以及公式是否误放进代码块。

九、用流程图说明思路（可选）

流程比文字更容易说明时，可以用 mermaid 代码块。下面的例子表示“读题 → 分析样例 → 写代码”，复制到左侧后检查右侧预览：

```mermaid
flowchart TD
    A[读题] --> B[分析样例]
    B --> C[选择算法]
    C --> D[写代码并测试]
```

流程图只是辅助理解。节点文字尽量简短；如果预览没有按预期生成图，先检查第一行语言名是不是 mermaid，再检查每条箭头是否写成 -->。

十、可以直接改写的题解模板

不知道从哪里开始时，复制下面的骨架到正文，再把方括号里的提示改成自己的思考。请写出为什么这样做，不要只贴最终代码。

## 题目与目标
[用自己的话概括输入、输出和限制条件。]

## 思路
[先说明观察到的规律，再解释为什么想到这个方法。]

## 算法步骤
1. [第一步]
2. [第二步]
3. [最后一步]

## 正确性说明
[解释每一步为什么不会漏掉正确答案。]

## 复杂度
- 时间复杂度：$O(n)$，因为 [说明主要循环执行次数]。
- 空间复杂度：$O(1)$，因为 [说明额外使用了哪些变量]。

## 关键代码
```cpp
// 只放有助于理解思路的关键代码
```

## 样例与边界
| 情况 | 输入或特征 | 预期结果 |
| :--- | :--- | :--- |
| 普通样例 | [填写] | [填写] |
| 边界样例 | [填写] | [填写] |

## 复盘
[这次最容易错在哪里？下次怎样更快想到方法？]

写学习笔记也可以沿用这个结构：把“题目与目标”改成“今天学了什么”，把“正确性说明”改成“我的理解”，保留例子和复盘即可。

十一、常见问题与提交前检查

预览和预期不一样，先检查什么？

标题没变大：检查井号后有没有空格，标题是否单独占一行。
换行没出现：新段落留一个空行；段内换行检查上一行末尾的两个半角空格。
表格散开：检查第二行的 --- 分隔行和各行列数。
公式显示原文：检查 $ 或 $$ 是否成对、反斜杠是否漏写。
图片或附件打不开：检查上传是否完成，是否用了电脑本地路径，登录状态是否有效。
工具栏没有加载：刷新页面，尽量通过网站地址进入投稿页；直接打开本地 HTML 文件不能完成正式文件上传。

提交前花一分钟检查

标题能概括文章内容，正文中的小标题有清楚的先后顺序。
每个重要结论有例子或解释，代码和公式在右侧预览中能看懂。
所有网页链接都能打开；图片显示正常，附件上传已完成。
用 Desktop 和 Mobile/Wechat 各看一次，确认表格、长代码在窄屏下仍可阅读。
没有写入姓名、学校、班级、联系方式、密码或其他不该公开的信息。
需要继续修改就先保存本机草稿；准备好后再点击“提交审核”，等待审核结果。

好的题解不一定最长。让同学能顺着你的观察、方法、代码和边界测试走一遍，比堆很多术语更有帮助。

开始投稿返回博客