四年 DEV 写作经验总结:20+

2025-05-25

四年 DEV 写作经验总结:20+

在过去的 4 年里,我写了 69 篇文章,我渴望与大家分享我迄今为止学到的知识。

我的学习还远远没有结束,所以如果您有关于撰写优秀文章的其他建议,欢迎在评论区留言

1. 首先,开始吧🎬

如果您还没有写过第一篇文章,那么您在这里读到的任何内容都无关紧要。

因此请务必开始,如果您不确定如何开始,我会为您提供指南!

2. 不要埋没重点⚡️

您的第一句话应该包含文章中最重要的内容。

您可以用以下测试来判断文章中的引言是否被掩盖了:

您的文章的第一句话是否可以作为一条好的推文来介绍您的文章?

我想说的是,这个相当不错:

主页___Twitter

这个相当糟糕:

主页___Twitter

3. 在纸上集思广益

要写好文章,你需要一个好的主题,可以是你自己感兴趣的主题,也可以是公众要求的主题(*)。你需要一个好的标题,以及一个关于你希望通过这篇文章实现什么的使命宣言。

我发现找到多个好标题比只找到一个好标题更容易。我的意思是,当我写完一篇文章筋疲力尽时,想出一个好标题是很困难的。另一方面,如果我放松的大脑只专注于构思主题、标题和使命宣言,我的创造力就会迸发。每个人的情况可能不同,但对我来说,没有什么比纸笔更适合头脑风暴了。

(*) 额外福利:https://answerthepublic.com/是一个很棒的工具,可以帮你了解公众想读什么。输入你的主题,你就会得到谷歌上最常见的问题列表。

4. 和朋友讨论一下

文字总是来得容易——从来没有作家说过。

一个非常有效的策略是:

1)尽快写出一份糟糕的初稿,不要有任何结构或格式的阻碍。

2)与朋友讨论:“......我发现非常有趣的是....../......我真正想说的是......”。

3)现在写下你希望与朋友讨论的文章。

5.学习Markdown

如果您还没有学习 Markdown,请将其放在您的待办事项列表中,因为您需要它来很好地格式化内容。

它不仅可以帮助您在 DEV 上,还可以帮助您在 GitHub、StackOverflow、博客软件和更多网站上。

我不会详细说明这一点,因为@yechielk已经很好地解释了 markdown,所以请收藏此内容:

6.添加目录✅

Markdown 的一个缺陷是没有内置方式可以说:“嘿,请在此处插入目录”。

如果您使用 Visual Studio Code,我推荐您使用Marky Dynamic,它可以插入和更新自动生成的目录。

这就是本文的目录的构建方式。

7. 保持流动性

DEV 有允许预览链接的液体标签

{% post https://dev.to/jmfayard/things-i-ve-been-writing-on-dev-to-22io %}
{% github jmfayard/refreshVersions no-readme %}
{% tag kotlin %} 
{% comment 2d1a %}
Enter fullscreen mode Exit fullscreen mode

GitHub 徽标 拆分/刷新版本

人生苦短,没时间去 Google 查找依赖项和版本

#科特林

一种跨平台、静态类型、具有类型推断的通用编程语言

刪除代碼。

(这里的背景是:处理有问题的遗留代码,并达到拥有执行相同操作但没有问题的新代码(路径)的程度,以便可以丢弃旧代码及其问题)

编辑器中有一个友好的文档。

新帖子-_DEV_Community_👩💻👨💻

8. 使用表情符号😄

尽可能多地添加表情符号,打破大段文字的单调。

我以前认为这很荒谬,但我改变了想法。

9. 使用#️⃣标签

花点时间了解https://dev.to/tags上有哪些可用的标签

与技术相关的标签非常明显:#javascript #css #java #python...

您需要注意以下跨切标签:

  • #beginners如果他们能够阅读您的文章。
  • #productivity如果你有提高工作效率的秘诀。
  • #career与工作和职业相关的任何事情。
  • #showdev来展示你所建造的东西。

一些标签具有不太明显的规则,您需要注意:

  • #discuss用于引起社区反应,但不适合博客文章。
  • #help是请求帮助,而不是帮助别人。
  • #opensource是为了讨论开源的哲学和实践,而不是为了推广你的开源项目。
  • #watercooler这对我来说很难理解,因为我在法国生活过,那里人们会围着咖啡机讨论一些略微偏离主题的事情,在德国,人们也会在啤酒花园里讨论。那里没有饮水机。

10. 在 GitHub 上上传图片

您可以使用屏幕截图、注释、形状和草图,用更少的文字表达您的观点。

我很乐意使用Skitch来实现这一点。

我不喜欢的一件事是在编辑器中上传图片。

解决方法是,我遇到了一个 GitHub 问题,我拖放了所有图片

Markdown_drag_drop_pictures_·_Issue__1_·_jmfayard_writing

11. 开始一个系列⏭

您无需撰写一篇长篇文章,而是可以将您的想法分成一系列文章来阐述。

确保使用系列功能,以便将不同部分链接在一起。

新帖子-_DEV_Community_👩💻👨💻

12. 最初发表于您自己的博客🔗

尽管我喜欢 DEV,但我还是想继续拥有我的内容。

为此,您需要设置规范 URL,以链接到您自己博客上的副本。这将告知 Google 和其他搜索引擎该文章的原始来源,并防止它们将该dev.to文章标记为重复内容(从而将其从搜索结果中屏蔽)。

编辑帖子-_DEV_Community_👩💻👨💻

13. 使用 Stackbit 生成你的博客 ❤️

您还没有自己的博客吗?

不用再等了,您可以根据在 DEV 上发布的内容来生成它。

https://dev.to/connecting-with-stackbit

这是我用于https://jmfayard.dev/的

我喜欢它的低维护性!

14. 添加封面图片🌅

如果您在文章上花费了时间和精力,您肯定不希望它在 Twitter/Slack/Whatever 上分享时看起来像一个无聊的链接。

因此您需要一张尺寸为 1000x420 的封面图片

(我总是忘记这个信息)。

我是一名后端人员,因此我努力制作出像样的封面图片。

我最喜欢的策略是编写编程代码并使用https://carbon.now.sh/将其转换为华丽的图像

这就是我在Android 十亿美元错误中所犯的错误

如果您会画画,您就拥有超能力,您应该在这里使用它!

我不能,但我的妻子制作了这幅很棒的漫画“你现在的工资是多少?”这是一个危险信号,表明你不想在这里工作

如果您经常发布同一主题的文章,Canva是一个很好的工具,可以用来制作品牌形象,您只需更改标题即可。

这是我在“如何学习 Kotlin:浏览器与 IDE、书籍与教程,面向新手和 Java 开发者 - DEV 社区 👩‍💻👨‍💻”中使用的内容

最后,同样重要的是,@pjijin制作了一个很棒的封面生成器。我在本文中用到的就是它:

15. 使用 Markdown 编辑器写作✍🏻

DEV 有自己的编辑器,网址为https://dev.to/new,但如果我说独立的 Markdown 编辑器更好,他们不会生气。

由于 Markdown 是一种标准(实际上并非如此,但这是题外话),您可以尝试多种编辑器:

  • Visual Studio Code一如既往地好,并且它有一个拼写检查器。
  • Notion是一个不错的选择。
  • Typora是我目前最喜欢的,因为它的界面不受干扰。

16. 推送到私人 GitHub 仓库👨🏻‍💻

一旦你开始使用独立的 Markdown 编辑器,下一步就是将你的更改推送到 GitHub、Gitlab 或任何你喜欢的地方。

我从@john_papa那里得到了这个提示

保存我的内容并确保不会丢失(我的两个目标)通过创建一个 GitHub 仓库来强化。我更喜欢将其设置为私密,因为里面存放了我大量的写作内容。我还以一种对我来说合理的方式来组织我的仓库。这样我就可以快速找到我的文章,进行修改、迭代,并继续前进。

17. 如果英语不是你的母语……🇬🇧

能够用外语写出一篇完整、易读、没有愚蠢错误的文章是一段艰苦的多年旅程。

即使过了25年,我仍然远非完美。

我感受到你的沮丧。

我强烈推荐@vtrpldn的这篇文章,他分享了应对挑战的有用技巧:

18. 尽早发布,经常发布

润色一篇文章直到一切准备就绪通常是一件很累人的事情。

我的建议是:在您准备好之前点击“发布”按钮。

你怕什么?又不是说你一发表就有几千人看,这种事永远都不会发生。

发表一些文章可以缓解完成文章时的一些压力。

现在再次阅读您发表的文章,并逐步改进需要纠正的内容。

19. 立即发布,稍后分享📣

发表一篇文章通常很累,我建议你不要在文章完成后立即分享。

我有一个朋友,他写的是史诗般的超长故事,我很惊讶和嫉妒他后来又写了 1,000 个字来在 Facebook 和 LinkedIn 上推广他的作品。

他的秘诀是给大脑时间放松。他周一“完成”了一篇文章,周二发布,周三分享。

20. 警惕虚荣指标

包括 DEV 在内的博客平台可以让您了解文章的浏览量。

当你看到一个数字时,希望它变大、不断增长,这是人的本性。

我想提醒大家:这就像一台享乐跑步机,对你来说没什么好处。
一旦你达到了目标,你就会习惯它,而当你再次达不到目标时,你就会感到失望。

设定毫无意义的目标很危险。我建议你专注于你的影响力、有意义的对话等等。

[更新] 更多提示

我所有的写作都是在Obsidian中完成的,它的使用方式与 Notion 类似,但从技术上讲,它更像是作家的 VS Code,基本上是一个带有无限插件的导航器。

我这里已经有 381 个文件和 12k 行文本,这是我开始时从未想到的。

如果您想惨败,我推荐的主要流程是尝试一次性写一篇大文章,直到完美为止。

我建议你先写个烂初稿,不要评判,也不要按退格键。
之后我会重新调整。

我已经提到过 Anne Lamott 的建议,现在的新想法是,ChatGPT 通常非常适合生成那些糟糕的初稿。再也不用忍受“空白页综合症”了,这很重要。

我发现安排时间真的很重要。我建议你总是安排好你的帖子发布时间。这样可以消除“我的文章准备好了吗?”的压力。谁在乎呢,你把它安排在周一早上9点。在那之前你随时可以改进。而且一旦发布,你就不会再刷新通知,比如“哦,我希望有人喜欢我,给我发个表情符号”。相反,你会忘了它,它会是一个友好的评论,提醒你你确实发布了一些东西。

我还建议你选择一个节奏。比如,我会尽量每周一早上9点发帖。哪个节奏?每天?还是每个月?没有什么规则,只要节奏适合你就可以了。我们都是习惯的动物,所以这真的能让你更上一层楼。

但对我来说,最大的好处是使用Swipe File,一旦开始写作,就可以从中挑选文章灵感。这样你就不用再面对空白屏幕,问自己:“今天要写什么?”而是把构思和写作分开了。如果你在巴黎遛狗时突然想到了一个很棒的文章创意,就把它放进 Swipe File 里。

滑动文件是一个概念,而不是一个应用程序,您可以使用任何应用程序来实现它,例如Bear(iOS)、Google Keep(Android)、SimpleNote(全部)一个非常重要的规则是,您必须
将该笔记应用程序用于此目的。

例如,对于这个评论,我实际上已经从我的滑动文件中写下了更多书面提示的想法:)

我最后的建议是,写作很棒,放手去做就好,别担心一开始写得不好。这就像编程一样,全靠练习。

现在我只需要将此评论嵌入到我之前的写作技巧文章中。

你呢?

您在定期写作时遇到过哪些挑战?

您使用了什么策略来克服它们?

有什么文章想分享吗?

如果你想给我写信,可以访问https://jmfayard.dev/contact/并收到长期邀请。

文章来源:https://dev.to/jmfayard/20-lessons-i-ve-learned-writing-on-dev-for-4-years-4nk3
PREV
💥 #explainlikeimfive 精选 开发者角色 网络 编程 方法论 框架 DevOps
NEXT
如何使用 Node.js、React.js、Nodemailer 和 OAuth2 实现电子邮件功能