前言：作为既有博客也有公众号，每天都需要写接口文档的高级技术人员，每天都很有必要写。 在使用markdown之前，我用各种奇怪的方法写文章。 其中也有word和txt等传统方法。 相反，并不是说人们常用的传统方式错了，而是想告诉大家，马克德沃恩比其他编辑方式有自己的优点。
如果你
写作和写作的需要对格式有一定的要求，但很少要求正确的格式。 我想把重点放在写作本身上，我想在格式上多花点力气。
如果你还在用txt和word写，在聊天窗口写界面文档的话，我真的很想学习markdown。
markdown介绍了百度百科学说
Markdown是一种标记语言，可以使用常用文本编辑器编写，它通过简单的标记语法使常用文本内容具有一定的格式设置。 据维基百科报道
markdownisalightweightmarkuplanguagewithplaintextformattingsyntax.itsdesignallowsittobeconvertedtomanyoutputformats， buttheoriginaltoolbythesamenameonlysupportshtml.markdownisoftenusedtoformatreadmefiles，forwritingmessagesinonlinediscuscusiosioniored andtocreaterichtextusingaplaintexteditor .总之，markdown是一种语言，可用于创建文档。 您可以使用简单的标记语法来编写具有一定格式和样式的文档。
markdown在博客程序中广泛使用，在一些博客引擎中，markdown最终转换为html元素，markdown最终转换为html文档。 使用这种方式的博客引擎有hexo、typecho等。
markdown由github指定为自述文件格式，github中每个目录下的自述. MD文件被视为当前目录的解释文件，并显示在详细信息页面上。
markdown的语法很简单，只要学一点，就能很容易地使用。
但是，markdown也有其局限性。 例如，大多数markdown的使用场景都在计算机上，由于移动端的输入特性，markdown没有支持移动端的好方法。 此外，markdown支持的格式无法实现论文的准确格式要求，因此不适用于格式要求过强的场合。
markdown的基本语法markdown文档的扩展名为. md。
markdown文档不需要标签。 可以在扩展名为. md的文件中的任何位置写入符合markdown语法的内容。
markdown语法是通用的markdown文档约定，并不意味着以下内容在实际应用中由所有编辑器和解释器输出为相同的结果。 通常，在博客系统中，markdown会转换为html。 在转换过程中，开发人员会根据自己的喜好和主题要求，将markdown内容转换为特定的样式，从而正确美化markdown文档。 但是，markdown文档通常遵循以下语法中描述的规则： 标题在一行字符前写1-6个#符号，当前行被视为标题。 一个#符号表示一级标题，大小在标题中最大； 6个#符号表示6级标题，大小为标题中最小的。 标题用粗体处理，单独占领一行。
#这是一级标题##这是二级标题###这是三级标题###这是四级标题####这是五级标题###这是六级标题的实现效果是
这是一级标题这是二级标题这是三级标题这是四级标题这是五级标题这是六级标题字体下面显示一些字体的写法。
**粗体字两侧用两个*括起来，***斜体字两侧用一个*括起来，****粗体字斜体字两侧用三个**括起来，***~加上删除线的文字两侧用~括起来的结果
粗体文字的两侧用两个*括起来
倾斜的文字两侧用*括起来
粗斜的文字两侧用3个*括起来
要加入删除线的文字的两侧用~括起来
使用引用的字符开始，以下段落以引用格式显示。 例如
如果引用字符需要多行，则可以使用br折叠此段落中的行。
第1行br2行
第一行
如果第二行的内容太多，则必须使用blockquote标记。 此标签中的所有内容都将以引用格式显示。
blockquote这个字真的很放心。 不管换多少行都是引用/blockquote这个字真的很放心
不管换多少行
都是引用，引用可以和其他标签一起使用。
#将级别1的标题置于此引用中将级别1的标题置于此引用中的引用可以使用多个级别
我打算在这里拉
用点东西>> 我打算弄个第二层 我打算在这引用点东西我打算弄个第二层 分割线
使用 >= 3个的 * 或 - 号都可以表示一个分割线。
------******下边是两个分割线
列表使用 + - * 来表示无序列表，符号和内容之间要有一个空格。
+ 列表- 列表* 无序列表 列表列表无序列表使用任意数字来表示有序列表，数字和内容之间要有一个空格。数字顺序不会影响列表真正的数字顺序。
1. 第一个2. 第二个4. 就算写的是4实际上也是3 第一个第二个就算写的是4实际上也是3列表之间可以嵌套，子级比父级多打3个空格即可。
1. 第一个 1. 第一个里的第一个 1. 第一个里的第二个2. 第二个3. 第三个 + 第二个里咋啥都没有 * 我也不知道 - 我也不敢问 第一个 第一个里的第一个第一个里的第二个第二个第三个 我也不敢问我也不知道第二个里咋啥都没有 链接使用[链接显示内容](链接地址)来表示一个点击了会跳转的超链接。
[百度](http://www.baidu.com)百度
图片使用来表示一个图片。
 表格表格的格式较复杂，但是一些markdown编辑器都会提供快捷的编写表格的功能。
表格的格式是
|表头|表头|表头|表头||--:|--|--:|:--:||右|默认左对齐|靠右|中||右|默认左对齐|靠右|中||右|默认左对齐|靠右|中|实现效果是
表头表头表头表头右默认左对齐靠右中右默认左对齐靠右中右默认左对齐靠右中
表格使用类似|:--:|:--:|:--:|:--:|来分割表头和身体。表头、分割线、表体的格子数都要一样。分割线中不加:，该列默认左对齐；右边加:，该列右对齐；两边加:，该列居中对齐。
原生的markdown语法要求表格两边都要用 |包起来，一些特殊的markdown引擎没有此要求。 代码 `单行代码两边使用反引号包起来`单行代码两边使用反引号包起来
``` 多行代码上下使用三个反引号包起来 ```//多行代码上下使用三个反引号包起来function fun($a) { return a + 1;}在多行代码的第一组三个反引号右边，可以标注代码所属的语言，这样可以方便markdown转译时做相应处理。例如
```php public function split($d, $str) { return explode($d, $str); } ```public function split($d, $str) { return explode($d, $str);}代码功能也不一定应用于代码，在一些文献的编写中，可以用于公式。代码块的功能主要是可以将里边写入的内容按原样显示，不被markdown解释器所解释。本文的markdown标记部分全部都是使用代码块的方式写的。
markdown高级用法 应用于一些博客系统在上一篇文章中提到如何使用hexo搭建一个个人博客。搭建成功后，就可以使用markdown语法来写文章了。由于hexo使用的是markdown引擎，所以在执行hexo g的时候markdown会被hexo转译为对应的html形式。再加上hexo有优秀的主题模块，同样的markdown遇到不同的主题，也会变成不同的样子。
如果使用typecho博客引擎的话，hi在编写博客的时候使用markdown，但是不会被马上转译为html。在查看对应内容的时候，typecho会使用markdown解释器来显示文档内容。
如果你会使用html标签markdown文档中是可以插入html标签的，所以如果你会使用html标签，你的markdown文档会更加丰富的。例如我们可以使用css样式来使markdown文档内容具有颜色。例如：
<span style="color:red;">这行字是红色的</span>这行字是红色的
虽然markdown支持使用html来丰富内容，但在实际使用上还是不建议过多依赖于这种形式。因为我们选择使用markdown时就是看中了markdown简单快速，但是html标签的支持却与markdown本身的理念背道而驰。所以建议偶尔使用或者是在必要的时候使用html标签来增强markdown的功能或者是完成必要的内容，而不是过度依赖于html来编写markdown文档。
一些工具 typora推荐使用typora来作为markdown编辑器。它符合markdown的初衷，简洁、高效。输入好的一段markdown文档，会在你光标切换到下一段的时候直接显示为markdown应该成为的样式。但是缺点也有一些，例如不支持多标签，没有命令行工具。typora支持windows、macOS、Linux平台，官网提供主题下载功能。
vscode如果你的电脑上有vscode，同样推荐你使用vscode来编写markdown。vscode默认支持markdown解析，并可以将界面分成左右两边显示，左边输入markdown文档，右边显示结果。vscode比typora更多地支持命令行工具，所以在使用一些博客系统的时候会感觉到更舒服一些。
vscode也有更多的插件可供选择，如果对typora的“马上就能看到结果”不太感兴趣的话，不妨试试vscode。
sublimesublime和vscode原理相同，支持命令行，可以安装插件。但是vscode完全免费，就没有尝试sublime。
结语markdown真的很好用，很多编辑器也支持将markdown导出为其他格式。试想老板让你几分钟之内做出一篇文档，当别人还在等待word打开的时候，你的文档已经写好开头了。当别人给老板甩过去一个.doc的超大文件，老板也在等待word打开的时候，你使用markdown生成的html两秒内就展示在老板面前了，是不是这样的结果可以让人眼前一亮呢。
还有那个notepad，打开就白底黑字，缩进都支持不全，打上去的都是楷体字巴丑巴丑的。还有好多同行在聊天窗口里打代码，每行有几个缩进就按几个Tab，还不一定缩得准；一个手滑就把换行里的shift忘掉了导致打了一半的代码发出去了。所以我求求你们了，都学一学markdown吧，真的比你们用的好用好几百倍，效果更是比你们实现的效果强好几千倍。