全面指南:技术写作与编辑工具 Markdown、Git 研究工具
技术写作工具
在技术写作领域,“工具”是指技术写作者用于创建、管理和发布高质量技术文档的各种软件和应用程序。这包括文字处理器、桌面出版应用程序、XML 编辑器、内容管理系统等等。一些技术写作者常用的工具示例包括 Microsoft Word、WPS、Typora、Notion、印象笔记、GitHub、飞书云文档
和 VSCode
等。这些工具通过允许文档版本控制、启用协作、提供用于一致格式设置的模板、提供管理大量内容的功能,甚至提供将文档翻译成多种语言的功能,从而提高了生产力。工具的选择取决于技术写作者或其工作的组织的具体需求和工作流程。
编辑工具
编辑是指审阅和纠正书面材料以提高准确性、可读性和适用性的过程,并确保它没有错误、遗漏、不一致和重复。在技术写作中,有效的编辑对于生成高质量内容至关重要。这包括检查文档是否存在语法错误、标点错误和拼写错误。它还包括检查事实准确性、逻辑流和连贯性。有几种可用于编辑的工具,例如 Grammarly、VSCode
插件和浏览器插件等。这些工具通过提供语法检查、拼写检查和写作风格反馈等功能,帮助技术写作者进行编辑过程。
Markdown
Markdown
是一种轻量级标记语言,具有易于读取的纯文本格式化语法。它由 John Gruber
创建,Aaron Swartz
做出了重大贡献,其目标是让人们“使用易于阅读、易于书写的纯文本格式进行写作”。主要功能包括从“可读”文本文件中自动生成结构良好的、随时可发布的文档。其语法包括标题(# 标题)、项目符号列表(- 项目)、斜体 (文本)、粗体 (文本)、链接 (描述: url) 等。Markdown
文件通常以 .md
或 .markdown
结尾。
Git / 版本控制
Git
是一个免费且开源的分布式版本控制系统,旨在以快速高效的方式处理从小型到非常大型的项目。它易于学习,占用空间很小,性能极快。Git
允许并鼓励您拥有多个可以完全独立的本地分支。这些开发线的创建、合并和删除只需几秒钟。它还为非线性开发、众多工作流程和强大的功能(例如历史的强加密身份验证)提供强大支持。
研究工具
在技术写作者的工作中,研究工具至关重要,因为它们有助于获取、验证和组织创建技术文档所需的信息。根据您要寻找的信息,可以使用各种特定的工具。例如,可以使用 Google Scholar
、知网等专业数据库搜索科学论文。
用于组织和评估数据的工具包括 Microsoft Excel
等。请记住,工具的选择将取决于您的主题、您需要的信息类型以及您想要管理和呈现该信息的方式。
技术写作中的发布工具
在技术写作工具领域,发布扮演着重要角色。它涉及使文档最终可供用户访问的最后过程。有各种用于发布的工具,例如 Adobe FrameMaker、MadCap Flare、Jekyll 等,它们支持 PDF、HTML、ePub 等不同格式。它们还可以包括版本控制、协作和内容重用功能。这不仅使内容对用户易于访问,而且还确保文档保持一致和更新。
博客平台
“博客平台”是指允许用户在线创建、发布和管理博客的软件服务。一些著名的博客平台示例包括 WordPress、Blogger、CSDN
、掘金、思否、博客园、个人博客等。这些平台通常具有用户友好的界面,并提供各种定制工具以满足您的博客需求。例如,WordPress
具有灵活性,提供广泛的主题和插件,而 Blogger
以其可靠的 Google
集成而闻名。CSDN 在百度搜索引擎有较高的指数排名等等。每个平台都提供不同的优势,具体取决于您作为技术写作者的特定需求和专业化。
抄袭检查器
抄袭是指复制他人的作品、想法或表达,并将其作为自己的作品呈现,而不给予原作者应有的信用。这种不原创的做法被视为盗窃知识产权,在学术和专业环境中都会带来严重后果。在技术写作中,使用专业的抄袭检测软件对于确保内容的原创性和真实性至关重要。一般平台都会对抄袭进行检测。它们的工作原理是将您的作品与庞大的学术和专业文件数据库进行交叉引用,以识别可能构成抄袭的任何匹配短语。
SEO 工具
对于任何技术写作者而言,SEO
工具都至关重要,因为它们可以帮助简化优化内容以供搜索引擎使用的过程。市场上有各种各样的工具可用,其中一些最流行的工具包括 Google Analytics
以及一些 SEO
在线网站等。这些工具提供不同的功能,例如关键字研究、反向链接分析和网站审核。它们可以作为独立工具使用,也可以集成到内容管理系统中以实现无缝运行。但请记住,虽然这些工具可以帮助 SEO
,但有效的优化仍然很大程度上取决于高质量的内容和战略规划。
最后
为了方便其他设备和平台的小伙伴观看往期文章:
微信公众号搜索:Let us Coding
,关注后即可获取最新文章推送
看完如果觉得有帮助,欢迎 点赞、收藏、关注
全面指南:技术写作与编辑工具 Markdown、Git 研究工具的更多相关文章
- Md2All:好用的markdown文件转换工具,文章迁移微信公众号的利器
目录 简介 使用体验 极速上手 更多功能 总结 简介 markdown以简单的语法和强大的功能,征服了无数技术创作者,几乎主流的技术博客网站都开始支持markdown语言撰写博客.但是微信公众号的文章 ...
- 把vscode打造成技术写作神器
作为技术开发,大家平时肯定需要记录技术笔记.甚至有的同学还开通可自己的技术博客或者技术公众号进行创作. 这个时候有套趁手的写作工具尤为重要,节省下时间好好休息一下,对于咱们程序员来说更加重要.因为最近 ...
- 好用的Markdown 编辑器及工具
Markdown 是 2004 年由 John Gruberis 设计和开发的纯文本格式的语法,所以通过同一个名字它可以使用工具来转换成 HTML.readme 文件,在线论坛编写消息和快速创建富文本 ...
- android平台短视频技术之 视频编辑的经验分享.
android平台短视频技术之 视频编辑的经验分享. 提示一: 各位看官,这里分享的是视频编辑,即剪切/拼接/分离/合并/涂鸦/标记/叠加/滤镜等对视频的编辑操作.不是流媒体网络播放等功能,请注意. ...
- go语言生成markdown文档工具
虽然有go语言的swagger,但是go版本的swagger对代码的侵入比较大,因此抽空实现了基于GO语言生成markdown文档的工具 开源链接地址: https://github.com/w3li ...
- 黑客攻防技术宝典Web实战篇(二)工具篇
扫描工具.中间攻击工具.加密解密工具等. 1 TM Thread Module 2 burpsuite 代理.中间攻击.repeatur.spider.暴力破解(intrude).加密.解密.扫描器 ...
- GIT版本管理工具
原文:http://blog.csdn.net/ithomer/article/details/7527877 Git 是一个分布式版本控制工具,它的作者 Linus Torvalds 是这样给我们介 ...
- Git——版本管理工具(一)
Git 是一个分布式版本控制工具,它的作者 Linus Torvalds 是这样给我们介绍 Git —— The stupid content tracker(傻瓜式的内容跟踪器) 1. Git 背 ...
- [.net 面向对象程序设计进阶] (26) 团队开发利器(五)分布式版本控制系统Git——图形化Git客户端工具TortoiseGit
[.net 面向对象程序设计进阶] (26) 团队开发利器(五)分布式版本控制系统Git——图形化Git客户端工具TortoiseGit 读前必备: 接上篇: 分布式版本控制系统Git——使用GitS ...
- 【运维工具】Git代码发布系统
引言 代码发布系统是互联网公司必备的运维系统,作用主要用户发布业务代码 到 业务服务器 为什么需要代码发布系统 有的同学可能说,我们公司服务器就那么一台,做个发布系统太麻烦了? 不认同这说法 发布系统 ...
随机推荐
- hibernate-delete(Entity)的顺序问题
hibernate为我们提供了删除直接根据实体参数删除数据的方法: HibernateTemplate().delete(entity); public void delete(final Objec ...
- 【Azure 环境】标准版 Logic App 如何查看 Workflow的执行成功数和失败数的指标呢?
问题描述 在Azure中创建逻辑应用(Logic App),有两种计划类型.一是消费型,另一种是标准型. 在消费型的Logic App Metrics页面中,我们可以看见Workflow的执行成功数指 ...
- go grpc流式和非流式的例子
参考grpc官方: https://grpc.io/docs/quickstart/go.html 或官方中文翻译: http://doc.oschina.net/grpc?t=60133 安装pr ...
- Linux上使用CMake简单例子
记录一下自己简单在linux-Ubuntu上用cmake的例子 首先安装cmake sudo apt install cmake 然后创建一个文件夹,里面放点例子代码 main.cpp //main. ...
- Spring Cloud跟Dubbo区别?
Spring Cloud是一个微服务框架,提供了微服务中很多功能组件,Dubbo一开始时RPC调用框架,核心是解决服务调用间的问题, Spring Cloud是一个大而全的框架,Dubbo更侧重于服务 ...
- Java 属性赋值的先后顺序
1 package com.bytezero.circle; 2 /** 3 * 4 * @Description 5 * @author Bytezero·zhenglei! Email:42049 ...
- MongoDB可视化compass 连接数据库失败Invalid UTF-8 string in BSON document
An error occurred while loading navigation: Invalid UTF-8 string in BSON document 出现这个问题建议降低compass版 ...
- 精贴总结 - 万字长文带你入门Istio
原文 - 万字长文带你入门Istio 一.个人看法 背景:以docker+k8s普及,支持快速部署,通过k8s允许统一管理 解决:1)设计分布式系统,导致开发难度提高:2)统一多语言的服务治理方案 目 ...
- CYQ.Data 支持 KingbaseES人大金仓数据库
KingbaseES人大金仓数据库介绍: KingbaseES是一种关系型数据库管理系统,也被称为人大金仓数据库.KingbaseES 是北京人大金仓信息技术股份有限公司研发的,具有自主知识产权的通用 ...
- A left join B B表有多条记录,max(create_time)取最新一条
例如:A表合同表t_contract B表合同审核表t_contract_audit.两个表根据contract_id关联.且一条合同有多条审核记录.求:A.合同状态.B.最新审核记录结果. 简单: ...