详细内容或原文请订阅后点击阅览
如何格式化你的TDS草稿：新版指南
关于在我们的贡献者门户上创建草稿，您需要知道的一切《如何格式化您的TDS草稿：全新改进指南》一文首次发表于Towards Data Science。
来源:走向数据科学无论您是第一次投稿的作者还是TDS的老手，欢迎阅读我们的格式指南！
自2026年8月起，我们推出了定制的作者平台，以取代我们之前使用的WordPress网站。您可以期待在此获得更轻松、更直观、更精简的草稿撰写体验，但如果您希望获得如何将作品上传到TDS的指导，您来对地方了。
目录
当您想开始一篇新文章草稿时，请查找页面右上角的“+新文章”按钮。您会立即看到一个弹出窗口，邀请您添加作品的关键信息，如标题、副标题、主要类别和标签。如果您对其中一些不确定，没关系——在此阶段唯一必填字段是文章标题。您随时可以在之后编辑这些详细信息。
一旦您点击“创建文章”按钮，您将进入编辑器屏幕。现在需要考虑的另一个必填要素是特色图片。查看侧边栏以找到选择或创建特色图片的选项。
如果您已为文章创建了自定义图片，太棒了——点击“上传图片”并从您的电脑中选择它。如果您已将图片上传到您的媒体库，或决定重复使用旧文章中的图片，请选择“从库中选择”并选择您想要的图片。
您还可以选择使用AI直接从草稿生成图片——您猜对了——使用“使用AI生成”按钮。点击它，一个新的窗口将出现。
只需输入您的提示——请尽可能描述具体——然后点击生成。几秒钟后您将看到几个选项可供选择。
如果您需要关于选择特色图片的额外指导，或想回顾我们的指南，这里有一个常见问题解答涵盖了该主题。
基本要素完成后，是时候实际上传您的文章了。我们的精简用户界面将以最少的麻烦让您的草稿准备好接受审阅。
要添加常规文本，只需开始打字。要添加任何其他类型的内容或媒体，请始终以/键开始。一个块菜单将弹出，显示您可以添加的所有可用内容类型。
使用上下箭头滚动列表，在文章中的该位置选择您想要的块，然后从那里继续。让我们仔细看看您的选项。
不言自明！只需输入或粘贴您的书面内容。当您开始新段落时，它默认设置为文本，因此您实际上不需要使用/键。
要为文本的任何部分添加特殊样式，请突出显示相关部分，您将看到一个菜单弹出：
您可以在粗体、斜体、下划线、和内联代码之间选择。这也是您能找到链接按钮和对齐选项的地方。
如果您想为我们的编辑留下评论，文本框中是您应该去的地方。点击它，写下您的评论，如果您愿意，可以标记我们团队的特定成员，然后点击评论提交。
提示：要在一个整洁的空间中找到您所有的评论，请查看您的侧边栏，并点击“线程”选项卡。
在文章中创建清晰的结构层次有助于读者和搜索引擎浏览您的内容。每当您开始新章节时添加新标题，并根据其在文章中的位置选择合适的标题。
当您输入/heading时，您会看到六个级别可用。始终以H2开始新章节，并从那里向下层次：例如，第一节为H2，第1.1节为H3，第1.1.1节为H4，等等。请勿在文章正文中使用H1标题。
您可以根据需要选择创建项目符号列表和编号列表——只需从列表中选择正确的块即可。
提示：使用Tab键在主列表中嵌套二级列表。
选择引用块以突出特定观点或想法，或当您引用外部来源的较长段落时。
少量使用引用块可能非常有效，但不要过度——就像粗体或斜体文本一样，它们很快就会变得分散注意力。
有时，标题可能不足以在章节之间或内部创建视觉分隔。
在这种情况下，使用分隔符块——确保您选择虚线样式，这是我们为TDS选择的默认样式。
表格非常适合比较基准结果、产品特性等。表格块使创建光滑的表格变得非常容易。
表格下方和右侧的+按钮将分别添加行和列。弹出菜单中的其他设置允许您切换标题行和列、垂直对齐表格、删除行和列，以及完全删除表格。
许多TDS文章包含代码——有时是大量代码。我们上面介绍的文本块为您提供了内联代码样式，但这不是实用解决方案。您有两个不错的选择：
代码块
当您想直接将代码输入草稿并为其选择特定语言的语法高亮时，选择代码块。只需将您的代码粘贴到块中——然后，要么保持自动模式，让我们的网站选择最合适的高亮，要么滚动可用编程语言列表并选择相关语言。
如果块只包含输出、自然语言提示等，而不是工作代码，只需选择Markdown，它将保持纯文本。
GitHub Gists
您还可以选择将GitHub Gists直接嵌入到您的草稿中，如果您从代码库中提取工作，这可能很有用。
您需要做的就是粘贴您的gist URL，然后点击嵌入——它将神奇地出现在您的草稿和最终文章中。
我们定制编辑器的最大升级之一是添加方程、公式和任何其他大量数学符号内容变得多么容易。在这里，您也有两个选择。
内联数学
当您需要在行文中间插入数学符号或符号时，选择内联数学块——只需将其输入输入框，检查下方的预览以确保一切正常，点击保存，就完成了。
块数学
对于更长和更复杂的数学内容，选择块数学——在这里您可以真正发挥您的LaTeX魔法。再次，使用输入框下方的预览来确保所有的sigma和delta都在正确的位置。
对于图表、绘图、屏幕截图、动画等，使用图片块。您有几个选项：上传、使用媒体库中已有的图片、通过URL添加，或使用我们的内置AI工具生成一个。尽情发挥吧！
图片放入后，您可以点击它，一个设置弹出窗口将出现。在这里您可以控制其尺寸和对齐方式，添加alt和标题，如果您决定不使用它则删除它。
这里最重要的设置是标题。这是我们要求所有作者为其所有图片添加来源和许可信息的地方，包括他们使用AI生成和/或自己创建的图片。
提示：如果您的文章包含大量图片，并且您创建了全部或大部分，您可以通过添加一条类似“除非另有说明，所有图片均由作者提供”的说明来避免添加大量烦人的标题。然后您只需为从第三方获取的图片添加标题。
想要添加现场演示、您的一场讲座或您的音频ML项目所引用的歌曲？简单——只需使用YouTube、Vimeo或DailyMotion嵌入块将其嵌入。它们都以相同的方式工作：选择正确的块，粘贴您要添加的视频的URL，然后点击嵌入。结果是一个原生嵌入的、可控制的视频播放器：
在文章中包含社交媒体内容的最佳方式是嵌入它们——格式已经为我们的网站优化，您避免了棘手的版权问题，因为您本质上是在重新分享原始帖子。除了我们在上一小节中提到的视频嵌入，您还可以按照完全相同的过程嵌入推文和Reddit帖子：选择块，粘贴URL，点击嵌入，就这样！
使用链接嵌入块创建到其他URL的样式化嵌入链接。选择块，粘贴相关页面的链接，然后点击嵌入。
最后一点神奇之处，您可以通过添加“目录”块自动生成文章的可点击目录！它通过收集所有标题和副标题到TOC格式来工作，因此对文章内部结构的思考将在这里得到回报。
要创建它，只需将目录块添加到您希望它出现的任何位置——例如，在快速介绍之后。
提示：目录是可选的；它们通常在最长的文章和深度探索中效果最好，而在短篇、代码密集的文章中可能感觉有点多余。
如果本指南未解决您的问题或您遇到的问题，不用担心——您可以直接从您的草稿中联系使用。只需高亮任何单词，点击评论符号，并使用@符号标记我们团队的一名成员。