We read every piece of feedback, and take your input very seriously.
To see all available qualifiers, see our documentation.
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
写作可以加深自己对于知识点的理解，同时可以引导读者更好的去理解知识点。本文的主要目的是提高大家的写作意识和质量，主要分为四个部分：
温馨提示： 本文花了较多时间去思考如何写好技术类文章，主要用于组内分享。这里将写作技巧分享给大家，希望对没有写作习惯的同学有所帮助。当然，如果能从中获益并写出更优雅的简历，那再好不过了。
就个人而言，写作可以分为三个阶段：
刚进入特定技术领域进行学习时，可以培养摘录笔记的习惯（例如将书中的知识点或者别人的博客技术在自我实践后进行摘录或精简）。通过自我实践（改良）、精简以及总结可以加深对知识点的理解，同时也可以锻炼自我的文笔书写能力。除此之外，摘录或摘要笔记更便于后续快速回顾当下总结的知识要点。这里列出几个相对有参考价值的笔记：
温馨提示：这些笔记可能是时常翻阅最频繁的文档，可用来快速解决某些技术问题。
在工作的过程中，可以记录自己遇到的且难以解决的问题，并记录解决方案。如果问题相对较小，可以进行小问题汇总（便于后续遇到同类问题时可以进行快速定位）。如果问题相对复杂，则可以形成一个体系化的经验案例：
这里列出几个相对有参考价值的经验案例：
刚开始写作的时候可能很难形成体系化的文章，此时可以通过积少成多的方式进行慢慢积累（例如尝试书写豆腐块式的小段落）。
摘要笔记和经验案例可能更多的是面向自我（加深自我对技术的理解和提高文笔能力），此类文档对于读者可能很难有代入感（所遇到的问题越难解决或者记录的笔记越有深度，那么读者的普遍适用性就越差）。如果你想将你的知识点或经验分享给他人受益，那么一定需要对文章进行抽象、归纳和总结，从而使文章具有更广的通用性。对于这类技术文章建议采用以下结构：
前言要精简，尽量包含以下几个内容：
初衷主要让读者明白写这篇文章的主要原因和目的是什么。
适合人群主要说明文章适合阅读的群体范围，防止文章过于小白或过于深涩时对读者产生副作用，是一种提前打预防针的小技巧。
内容结构主要概括文章的总体内容，从而可以使读者感性的了解文章的大致结构，进一步确认是否要继续阅读或者跳过某些不感兴趣的部分。
温馨提示可以防止读者对文章产生一些使作者意想不到的误解，从而对文章产生一些不利的评论。
文章主体一定要符合文章前言的内容结构，除此之外内容尽量符合以下一些特性：
图文并茂可以降低读者的阅读疲劳感，切忌大段大段的文本段落，偶尔穿插一些图片、表格或者列表可以降低读者的阅读疲劳感。
框架大图主要用于进行分层结构的技术分析·。
表格分类对比主要用于同类型的内容对比（例如 React、Vue 或 Angular 等框架类型对比），这样可以使读者更加直观的了解各自的差异性。
可视化数据分析主要可针对一些性能优化或者性能监控等技术分析。
列表分类主要用于并行逻辑的内容呈现，这样可以使文章富有逻辑感且文案相对精简，连续的文本内容容易使读者抓不住段落的重点。
文章总结可以在最后告诉读者以下一些内容：
如果是一些技术方案类的实践总结文章，那么一定需要告诉读者方案的利弊分析、局限性及可扩展性、注意事项等，从而可以有效的使读者决定是否要采用或者借鉴类似的方案，当然如果能够指导读者如何根据业务场景灵活设计技术方案再好不过。
如果是一些技术科普类文章那么一定要告诉读者这类技术当下或未来的适用场景、可发展空间以及同类技术的横向对比等，从而可以指导读者是否需要深入研究该技术。
如果是一些不成熟的技术方案或者前言探索，最好能够提供一些深入阅读的文章链接，除此之外一定需要在文章结论中给出谦虚的表态，希望能够获取更多的建议或者意见，从而防止自己的主观认知带来的不确定性以及可能给读者带来的误导性。
建议在 VS Code 中采用 Markdown 格式校验插件 markdownlint （设置 Save Auto Fixed 功能进行 Markdown 格式化）、预览插件 Markdown Preview Enhanced 和快捷键插件 Markdown All in One 进行文档编写。
".,;:!?。，；：！？"
温馨提示：标题的作用不仅仅是使读者可以了解文章的整体结构，更多的是可以使读者快速跳转到他想要阅读的部分。
<url>
[link desc]()
Hi，大家好，我们是阿里巴巴新成立的 BU 政务钉钉事业部，目前还有大量的 Web 前端职位空缺。希望想找我内推或者想了解更多招聘信息的同学可以加我微信：18768107826
本文主要讲解了技术文章的写作技巧，此类技巧对于制作简历也会有所帮助。当然，如果你更需要的是技术类文档的写作风格（例如组件库、工具库以及脚手架等），建议参考阮一峰老师的中文技术文档的写作规范。希望大家平时能够养成写作的好习惯，这是程序员必备的技能之一。
The text was updated successfully, but these errors were encountered:
No branches or pull requests
前言
写作可以加深自己对于知识点的理解，同时可以引导读者更好的去理解知识点。本文的主要目的是提高大家的写作意识和质量，主要分为四个部分：
写作的阶段和价值
就个人而言，写作可以分为三个阶段：
刚进入特定技术领域进行学习时，可以培养摘录笔记的习惯（例如将书中的知识点或者别人的博客技术在自我实践后进行摘录或精简）。通过自我实践（改良）、精简以及总结可以加深对知识点的理解，同时也可以锻炼自我的文笔书写能力。除此之外，摘录或摘要笔记更便于后续快速回顾当下总结的知识要点。这里列出几个相对有参考价值的笔记：
在工作的过程中，可以记录自己遇到的且难以解决的问题，并记录解决方案。如果问题相对较小，可以进行小问题汇总（便于后续遇到同类问题时可以进行快速定位）。如果问题相对复杂，则可以形成一个体系化的经验案例：
这里列出几个相对有参考价值的经验案例：
刚开始写作的时候可能很难形成体系化的文章，此时可以通过积少成多的方式进行慢慢积累（例如尝试书写豆腐块式的小段落）。
文章结构
摘要笔记和经验案例可能更多的是面向自我（加深自我对技术的理解和提高文笔能力），此类文档对于读者可能很难有代入感（所遇到的问题越难解决或者记录的笔记越有深度，那么读者的普遍适用性就越差）。如果你想将你的知识点或经验分享给他人受益，那么一定需要对文章进行抽象、归纳和总结，从而使文章具有更广的通用性。对于这类技术文章建议采用以下结构：
文章前言
前言要精简，尽量包含以下几个内容：
初衷主要让读者明白写这篇文章的主要原因和目的是什么。
适合人群主要说明文章适合阅读的群体范围，防止文章过于小白或过于深涩时对读者产生副作用，是一种提前打预防针的小技巧。
内容结构主要概括文章的总体内容，从而可以使读者感性的了解文章的大致结构，进一步确认是否要继续阅读或者跳过某些不感兴趣的部分。
温馨提示可以防止读者对文章产生一些使作者意想不到的误解，从而对文章产生一些不利的评论。
文章主体
文章主体一定要符合文章前言的内容结构，除此之外内容尽量符合以下一些特性：
图文并茂可以降低读者的阅读疲劳感，切忌大段大段的文本段落，偶尔穿插一些图片、表格或者列表可以降低读者的阅读疲劳感。
框架大图主要用于进行分层结构的技术分析·。
表格分类对比主要用于同类型的内容对比（例如 React、Vue 或 Angular 等框架类型对比），这样可以使读者更加直观的了解各自的差异性。
可视化数据分析主要可针对一些性能优化或者性能监控等技术分析。
列表分类主要用于并行逻辑的内容呈现，这样可以使文章富有逻辑感且文案相对精简，连续的文本内容容易使读者抓不住段落的重点。
文章总结
文章总结可以在最后告诉读者以下一些内容：
如果是一些技术方案类的实践总结文章，那么一定需要告诉读者方案的利弊分析、局限性及可扩展性、注意事项等，从而可以有效的使读者决定是否要采用或者借鉴类似的方案，当然如果能够指导读者如何根据业务场景灵活设计技术方案再好不过。
如果是一些技术科普类文章那么一定要告诉读者这类技术当下或未来的适用场景、可发展空间以及同类技术的横向对比等，从而可以指导读者是否需要深入研究该技术。
如果是一些不成熟的技术方案或者前言探索，最好能够提供一些深入阅读的文章链接，除此之外一定需要在文章结论中给出谦虚的表态，希望能够获取更多的建议或者意见，从而防止自己的主观认知带来的不确定性以及可能给读者带来的误导性。
写作风格
建议在 VS Code 中采用 Markdown 格式校验插件 markdownlint （设置 Save Auto Fixed 功能进行 Markdown 格式化）、预览插件 Markdown Preview Enhanced 和快捷键插件 Markdown All in One 进行文档编写。
标题
".,;:!?。，；：！？"列表
代码块
引用
文本
<url>形式[link desc]()段落
文章
写作工具
招聘小广告
Hi，大家好，我们是阿里巴巴新成立的 BU 政务钉钉事业部，目前还有大量的 Web 前端职位空缺。希望想找我内推或者想了解更多招聘信息的同学可以加我微信：18768107826
总结
本文主要讲解了技术文章的写作技巧，此类技巧对于制作简历也会有所帮助。当然，如果你更需要的是技术类文档的写作风格（例如组件库、工具库以及脚手架等），建议参考阮一峰老师的中文技术文档的写作规范。希望大家平时能够养成写作的好习惯，这是程序员必备的技能之一。
参考文档
The text was updated successfully, but these errors were encountered: