四年 DEV 写作经验总结:20+
- 1. 首先,开始吧🎬
- 2. 不要埋没重点⚡️
- 3. 在纸上集思广益
- 4. 和朋友讨论一下
- 5.学习Markdown
- 6.添加目录✅
- 7. 保持流动性
- 8. 使用表情符号😄
- 9. 使用#️⃣标签
- 10. 在 GitHub 上上传图片
- 11. 开始一个系列⏭
- 12. 最初发表于您自己的博客🔗
- 13. 使用 Stackbit 生成你的博客 ❤️
- 14. 添加封面图片🌅
- 15. 使用 Markdown 编辑器写作✍🏻
- 16. 推送到私人 GitHub 仓库👨🏻💻
- 17. 如果英语不是你的母语……🇬🇧
- 18. 尽早发布,经常发布
- 19. 立即发布,稍后分享📣
- 20. 警惕虚荣指标
- [更新] 更多提示
- 你呢?
在过去的 4 年里,我写了 69 篇文章,我渴望与大家分享我迄今为止学到的知识。
我的学习还远远没有结束,所以如果您有关于撰写优秀文章的其他建议,欢迎在评论区留言!
1. 首先,开始吧🎬
如果您还没有写过第一篇文章,那么您在这里读到的任何内容都无关紧要。
因此请务必开始,如果您不确定如何开始,我会为您提供指南!
2. 不要埋没重点⚡️
您的第一句话应该包含文章中最重要的内容。
您可以用以下测试来判断文章中的引言是否被掩盖了:
您的文章的第一句话是否可以作为一条好的推文来介绍您的文章?
我想说的是,这个相当不错:
这个相当糟糕:
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 %}
#科特林
编辑器中有一个友好的文档。
8. 使用表情符号😄
尽可能多地添加表情符号,打破大段文字的单调。
我以前认为这很荒谬,但我改变了想法。
9. 使用#️⃣标签
花点时间了解https://dev.to/tags上有哪些可用的标签
与技术相关的标签非常明显:#javascript #css #java #python...
您需要注意以下跨切标签:
#beginners
如果他们能够阅读您的文章。#productivity
如果你有提高工作效率的秘诀。#career
与工作和职业相关的任何事情。#showdev
来展示你所建造的东西。
一些标签具有不太明显的规则,您需要注意:
#discuss
用于引起社区反应,但不适合博客文章。#help
是请求帮助,而不是帮助别人。#opensource
是为了讨论开源的哲学和实践,而不是为了推广你的开源项目。#watercooler
这对我来说很难理解,因为我在法国生活过,那里人们会围着咖啡机讨论一些略微偏离主题的事情,在德国,人们也会在啤酒花园里讨论。那里没有饮水机。
10. 在 GitHub 上上传图片
您可以使用屏幕截图、注释、形状和草图,用更少的文字表达您的观点。
我很乐意使用Skitch来实现这一点。
我不喜欢的一件事是在编辑器中上传图片。
解决方法是,我遇到了一个 GitHub 问题,我拖放了所有图片
11. 开始一个系列⏭
您无需撰写一篇长篇文章,而是可以将您的想法分成一系列文章来阐述。
确保使用系列功能,以便将不同部分链接在一起。
12. 最初发表于您自己的博客🔗
尽管我喜欢 DEV,但我还是想继续拥有我的内容。
为此,您需要设置规范 URL,以链接到您自己博客上的副本。这将告知 Google 和其他搜索引擎该文章的原始来源,并防止它们将该dev.to
文章标记为重复内容(从而将其从搜索结果中屏蔽)。
13. 使用 Stackbit 生成你的博客 ❤️
您还没有自己的博客吗?
不用再等了,您可以根据在 DEV 上发布的内容来生成它。
https://dev.to/connecting-with-stackbit
我喜欢它的低维护性!
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
刪除代碼。
(这里的背景是:处理有问题的遗留代码,并达到拥有执行相同操作但没有问题的新代码(路径)的程度,以便可以丢弃旧代码及其问题)