早期，大家都是使用富文本和office写博客，后来大家都改用了markdown，这是因为markdown是一个简单的标记语言。
使用标记语言，可以让我们的文档（博客）的内容和样式分离，甚至让计算机读懂我们文档的结构，使其将我们的文档任意转换格式。同时使用可扩展的标记语言，能够使用我们自定义的方言，去书写一些格式非常复杂但是具有结构性的内容。
因此，在这个时代已经没有人在希望用富文本或者office去写文档，我们要标记语言。
那么应该选用哪种标记语言呢？
xml：无疑是最优秀的标记语言，xml具有较高的可扩展性，定义规范。但是xml不适合书写文档，因为他过于规范，不够灵活，严格的语法要求使人生畏；而且他对于转义的处理过也不够方便，一个空格都需要六个字符表示（ ），也没几个人能够记住这些转义。离开编辑器我们也很难直接使用xml去书写复杂的格式文档。
markdown：无疑是最流行的用于文档书写的标记语言，它非常的简单，而且就是为了书写文档而生的。但是它不同于xml，扩展性不够，我们可以通过“```”扩展markdown的语法，但是书写起来非常不方便，而且格式也很混乱。 同时markdown方言太多，导致多种markdown编辑器编辑出的文档彼此居然不兼容。也许因为markdown的语法过于简单，因此用起来反而非常麻烦，相信很多让人都遇到过一个表格调整了半天显示还有问题的情况。这些问题都是因为markdown不具备xml的规范性导致的。
html：本身就没有扩展性，同时也没有markdown方便，更不适合书写文档。包含了xml和markdown的全部缺点。
jsx：对，你没看错，就是react提供的附属品——jsx。我们希望能够像写markdown一样方便，又希望像写xml一样规范并且有扩展性，而jsx不就是这样的一个标记语言吗？同时配合es6的模板字符串，可以完美地解决了转义问题。 使用jsx，并且实现像markdown和xml那样包装html，能够使我们使用可扩展的标记语言书写文档，这就是my-doc-jsx。
my-doc-jsx（以下简称docjsx）是一个使用jsx书写文档的工具，并支持多种形式的文档转换。docjsx主要特点有：
docjsx有着接近html的标签系统，每个段落都需要用标签标记起来，因此他不像markdown那样随意，格式上更加清晰整齐；同时他有着markdown一样的书写格式，他不像html那样层层嵌套，docjsx要求每个段落必须是并列关系，不能嵌套。
每一个docjsx必须使用doc标签定义。因为根标签的写法是固定的，所以docjsx可以省略根标签，不过省略了根标签就不符合jsx的书写规范，所以请酌情考虑。
{
`
一级标题
二级标签
`
}
可以简写为：
{
`一级标题
二级标签
`
}
定义段落的标签我们称之为块级标签，参考html中的块级标签，块级标签不能嵌套，系统提供的块级标签有：
定义标题
{
`这是一个一级标题
这是一个二级标题
这是一个三级标题
这是一个四级标题
`
}
定义菜单
{
``
}
定义段落
{
`这是一段话
`
}
定义图片，使用src属性定义
{
`
`
}
定义引用，用于特殊说明解释
{
`Here is a long quotation here is a long quotation here is a long quotation
here is a long quotation here is a long quotation here is a long quotation
here is a long quotation here is a long quotation here is a long quotation.`
}
定义代码展示，使用lang字段指出展示源码的语言。展示源码时候，最好用es6的模板字符串。
{
`{
\`function test(){
console.log("hello world！")
}
test();\`
}`
}
显示的效果为：
{
`function test(){
console.log("hello world！")
}
test();`
}
定义列表。
{
`0.test1
1.test2
2.test3
3.test4 `
}
定义表格，语法类似html的table，暂不支持合并单元格。
{
`
1
2
3
4
5
6
7
8
9
`
}
定义段落中的词语的标签我们称之为行内标签，参考html中的行内标签，块级标签可以嵌套内标标签，但是行内标签不能嵌套块级标签，系统提供的块级标签有：
定义超链接，通过href定义超链接的地址
{`点击可跳转百度
`}
用于定义词语的标记，被标记的词语会高亮显示。
{`高亮显示docjsx
`}
用于定义粗体
{`加粗显示
`}
定义代码展示，被标记的词语会高亮显示。
{`加粗显示
`}
编写好的jsx格式的博客无法直接展示，需要将它们转为其他格式后才能展示出来。docjsx支持将jsx格式书写的文档转为html或者markdown格式，而且可以运行浏览器、nodejs、命令行等多种平台上面。
在浏览标或者nodejs环境下，都可以使用docjsx将jsx文件转为html页面或者md文件中。
首先引入docjsx文件，如果是nodejs环境，执行：
{
`npm install my-doc-jsx`
}
在浏览器中，使用script标签和link引入dist目录中的myDocJsx.js文件。
{
`var htmlDoc = myDocJsx.convert(jsxDoc)`
}
这样就将jsx文档转为html文档。
目前仅支持chrome浏览器，未来会扩充浏览器的兼容性。
如果需要使用插件，则需要将插件的js文件，使用usePlugin函数将插件注册到docjsx中：
{
`const myDocJsx = require("my-jsx-doc")
const myDocJsxPluginAPI = require("my-jsx-doc-plugin-api")
//使用usePlugin函数将插件注册到docjsx
myDocJsx.usePlugin(myDocJsxPluginAPI)
//然后在执行转换
var htmlDoc = myDocJsx.convert(jsxDoc)`
}
转换函数，将jsx字符串转换为指定的文档格式输出。
| 参数名 | 参数类型 | 说明 |
|---|---|---|
| jsxStr | string | jsx字符串 |
| option | Object | 转换的配置。主要配置有：format，转换的格式配置，支持“HTML”和“MARKDOWN”两种 |
| 参数类型 | 说明 |
|---|---|
| ${`Promise |
转换好的指定格式的文档 |
使用usePlugin函数注册插件。
| 参数名 | 参数类型 | 说明 |
|---|---|---|
| plugin | Plugin | 注册的插件 |
docjsx提供了一套用于文档转换的命令行，与nodejs、浏览器环境不同，cli是直接对文件的格式做转换，而不是字符串转换。首先全局安装my-doc-jsx：
{`npm install my-doc-jsx -g`}
docjsx具体语法是:
{`docjsx [options] [command]`}
将jsx格式的文档转化为指定的格式。
{`convert|c [options]
例如：
{`docjsx c html ./doc-jsx/README.jsx ./`}
| 参数名 | 说明 |
|---|---|
| format | 转化的格式，支持html和md两种格式 |
| file | 需要转换的文件 |
| output | 转换成功后文件保存的目录 |
| option名 | 说明 |
|---|---|
| -w, --watch | 增加一个监听文件变化的监听器，每当文件保存一次，都会执行一次转换 |
| {`-p, --plugin |
增加插件，pluginName是插件的npm包名，多个插件用“,”分隔。要求插件在试用前必须用先按照其npm包 |
插件的api暂未稳定，暂时不对外开放。