原文:Markdown技术文档编写规范

Markdown技术文档编写规范 Markdown是一种可以使用普通文本编辑器编写的标记语言,通过简单的标记语法,它可以使普通文本内容具有一定的格式。 文档体系 结构 简介 Introduction : 必备 文件 提供对产品和文档本身的总体的 扼要的说明 快速上手 Getting Started : 可选 文件 如何最快速地使用产品 入门篇 Basics : 必备 目录 又称 使用篇 ,提供初级 ...

2020-07-02 16:43 0 522 推荐指数:

查看详情

基于 Markdown 编写接口文档

最近公司开发项目需要前后端分离,这样话就设计到后端接口设计。复杂功能需要提供各种各样的接口供前端调用,因此编写API文档非常有必要了 网上查了很多资料,发现基于Markdown编写文档是一种比较流行而且成熟的方案了,话不多说,我也搞一搞试试。 电脑操作系统:deepin深度 Linux64位 ...

Thu Feb 28 02:33:00 CST 2019 0 1989
基于typora编写Markdown文档

             基于typora编写Markdown文档                                         作者:尹正杰 版权声明:原创作品,谢绝转载!否则将追究法律责任。   去年我有些过关于Markdown语法的文档,今天我就来 ...

Sat May 08 06:15:00 CST 2021 1 1232
vscode使用Markdown文档编写

首先安装vscode工具,具体的使用可以参考之前的博文:《Visual Studio Code教程:基础使用和自定义设置》 VScode已经默认集成markdown文档编辑插件。可以新建一个.md文件Visual Studio Code 原生就支持高亮Markdown的语法,想要一边编辑 ...

Wed May 29 17:49:00 CST 2019 0 1219
vscode使用Markdown文档编写

首先安装vscode工具,具体的使用可以参考之前的博文:《Visual Studio Code教程:基础使用和自定义设置》 VScode已经默认集成markdown文档编辑插件。可以新建一个.md文件Visual Studio Code 原生就支持高亮Markdown的语法,想要一边编辑一遍预览 ...

Wed Apr 25 00:56:00 CST 2018 4 46137
谈谈技术文档编写

博客园里讨论编程的文章很多,却没有见过谁发表过文档撰写方面的,或者有,是有我不知道呢?但无可否认的是,涉及到到文档方面的极为罕见。这是否与程序员对文档编写不够重视有关呢。 作为一名程序员,我也曾经犯这样的错误,对于文档编写不够重视。但是长期地和客户接触中,发现文档的撰写极为重要,出色文档 ...

Mon Mar 11 22:40:00 CST 2013 41 5810
中文技术文档写作规范

使用 markdown 格式书写文档 只使用一二三级标题,三级标题下面的并列性内容使用列表展示 二级标题前使用行分隔符表示分隔 段落之间使用一个空行隔开 一句话或者以逗号分隔的句子,长度尽量保持在 20 个字以内,20~29 个字的句子,可以接受 禁止文字口语化 ...

Tue Dec 14 18:53:00 CST 2021 0 138
Typora编写Markdown文档的换行缩进问题

用Typora写Markdown文档,发现在用了列表后,回车想再开一段的时候,会带有列表序号,删除后只能和列表段对齐,缩进有问题。 解决方法: 想要另起一行时直接按两次回车。 或者使用command + [ 解决 网上的其他解决方法: 回车的时候用Shift+Enter光标 ...

Wed Aug 12 02:00:00 CST 2020 0 3606
使用markdown编写api接口文档

1、准备工作 下载vscode、node.js npm安装docsify,docsify教程 npm i docsify-cli -g 切换到程序目录运行 docsify serve docs 2、编写api文档 3、查看效果 4、代码已 ...

Sun Mar 13 03:47:00 CST 2022 0 1406
 
粤ICP备18138465号  © 2018-2025 CODEPRJ.COM