最新消息:20210816 当前crifan.com域名已被污染,为防止失联,请关注(页面右下角的)公众号

【无法解决】gitbook中表格中嵌入code代码

gitbook crifan 3055浏览 0评论

gitbook中写markdown,想要实现,在表格中嵌入代码,用:

<code>
| HTTP方法 | 主要目的 | 传入参数 | 额外说明或注意事项 | 示例代码 |
| :--- | :--- | :--- | :--- | :--- |
| `PUT` | 把某个资源的信息**整体**的**替换**掉 | 该资源的 **全部** 的字段 | 换言之:当某些字段没有传的话,则直接设置为`null` |```json
PUT /user/some_user_id

{
"name": "zhangsan",
"email": "[email protected]"
}``` |
| `PATCH` | 把某个资源的**部分**信息**更新**掉 | 该资源的(你想要更新数据的那)**部分**的字段 | `PATCH`是在`PUT`之后才提出来,进入官方规范的。目的就是,只更新你传了值的那些字段,保留其他字段的已有的值 | ```json
PATCH /user/some_user_id

{
"email": "[email protected]"
}
```|
</code>

结果显示:

markdown code inside table

code block inside table row in Markdown – Stack Overflow

只是github的写法,也不方便写,所以不去试了。

Markdown – code within table cell? : help

说是每行都用inline,貌似是最好的办法了。

Nesting a code block with table elements inside of a table cell results in incorrect rendering · Issue #465 · showdownjs/showdown

How to nest code within a list using Markdown – Meta Stack Exchange

试了:

代码中每行都用4个空格缩进:

<code>| HTTP方法 | 主要目的 | 传入参数 | 额外说明或注意事项 | 示例代码 |
| :--- | :--- | :--- | :--- | :--- |
| `PUT` | 把某个资源的信息**整体**的**替换**掉 | 该资源的 **全部** 的字段 | 换言之:当某些字段没有传的话,则直接设置为`null` |```json
    PUT /user/some_user_id

    {
    "name": "zhangsan",
    "email": "[email protected]"
    }``` |
| `PATCH` | 把某个资源的**部分**信息**更新**掉 | 该资源的(你想要更新数据的那)**部分**的字段 | `PATCH`是在`PUT`之后才提出来,进入官方规范的。目的就是,只更新你传了值的那些字段,保留其他字段的已有的值 | ```json
    PATCH /user/some_user_id

    {
    "email": "[email protected]"
    }
```|
</code>

结果代码是看起来生效了,但是不是内嵌在表格里的:

试试,每行都用inline:

<code>| `PUT` | 把某个资源的信息**整体**的**替换**掉 | 该资源的 **全部** 的字段 | 换言之:当某些字段没有传的话,则直接设置为`null` |`PUT /user/some_user_id`
` `
`    {`
`    "name": "zhangsan",`
`    "email": "[email protected]"`
`    }``` `|
| `PATCH` | 把某个资源的**部分**信息**更新**掉
</code>

结果:

直接报错:

<code>error: error while generating page "restful_rule/rule.md":

Template render error: (/Users/crifan/GitBook/Library/Import/http_restful_api/src/restful_rule/rule.md) [Line 31, Column 18]
  unexpected token: %
</code>

改为:

<code>| `PUT` | 把某个资源的信息**整体**的**替换**掉 | 该资源的 **全部** 的字段 | 换言之:当某些字段没有传的话,则直接设置为`null` |`PUT /user/some_user_id` ` ` ` {` ` "name": "zhangsan",` ` "email": "[email protected]"` ` }`|
</code>

结果:

不是要的效果,很难看:

再去试试code或pre的html:

<code>| `PUT` | 把某个资源的信息**整体**的**替换**掉 | 该资源的 **全部** 的字段 | 换言之:当某些字段没有传的话,则直接设置为`null` |&lt;pre&gt;
PUT /user/some_user_id

{
  "name": "zhangsan",
  "email": "[email protected]"
}
&lt;/pre&gt;|
</code>

看看结果如何:

很惨。

<code>| `PUT` | 把某个资源的信息**整体**的**替换**掉 | 该资源的 **全部** 的字段 | 换言之:当某些字段没有传的话,则直接设置为`null` | &lt;code&gt;PUT /user/some_user_id

{
  "name": "zhangsan",
  "email": "[email protected]"
}
&lt;/code&gt;|
</code>

结果:依旧不行:

【总结】

标准的markdown中,内嵌代码,是不支持的,所以没法实现(很好的效果)。只能放弃。

转载请注明:在路上 » 【无法解决】gitbook中表格中嵌入code代码

发表我的评论
取消评论

表情

Hi,您需要填写昵称和邮箱!

  • 昵称 (必填)
  • 邮箱 (必填)
  • 网址
82 queries in 0.167 seconds, using 22.12MB memory