Memorykk

never too late to learn

Hexo中Markdown语法失效问题

在Hexo站上用Markdown写博时发现好多语法失效问题，记录一下

目录

1.表格直接以源码显示无渲染

问题

| 左对齐 | 右对齐 | 居中对齐 |
| :—-| —-: | :——: |
| 单元格aaaaaaaaaa | 单aaaaaaaaaaaaaa元格 | 单元aaaaaaaaaaa格 |
| 单元格 | 单元格 | 单元格 |
| 单 | 单 | 单 |

解决

  • 表格和正文之间空两行。
  • Markdown中生成的表格十分简洁，这倒也符合快速的特点，如果想自定义样式，通过嵌入css实现，例如本例。
  • 我使用的Hacker主题，通用样式文件存放在themes\Hacker\source\css\base\normalize.css，对这种通用性的追加即可，其他主题同理。
居中对齐 对齐 居中对齐
单元格 单元格 单元格
单元格 单元格 单元格
单 单 单

待解决

表格正常显示之后，对齐方式却不生效，网上没找到和我一样问题的，不过这个需求也不大，或许只能通过css解决。

2.<kbd>无样式

问题

比如这个kbd标签，Ctrl ，看起来很不明显有没有，大概率本来就这样，但是我一开始希望它是这样：ctrl

提示: <kbd> 标签已废弃，不推荐使用，但是可以通过CSS实现丰富的效果。
——HTML<kbd>标签

解决

因为我感觉这个会很常用，但我给它加了css样式，还不错。Ctrl

3.插入<table>不渲染

问题

我在HTML里面测试好table，再将整个<table></table>粘贴到VSC的md文件中，但是这时HTML标签不渲染，直接以源码显示。

解决

  • 先在md中手写<table></table>这两个标签，再将table里面的内容粘过去，不要开始和结束标签。
  • 或者可能是HTML代码中有空行！

4.插入HTML标签产生大量换行

问题

插入HTML标签产生大量换行

解决

将HTML标签之间的空格删除，也就是写到一行中。

5.目录跳转无反应

问题

因为本主题（或是别的问题）不会生成文章目录结构，所以我一般写完后用MarkdownAllinOne生成目录，但是点击无反应，不跳转。

解决

  • 首先标题里不能有符号
    如果标题为”&总结”，但MarkdownAllinOne生成目录自动链接到”#总结”，Hexo渲染出的HTML源码却是：

    <h2 id="amp-总结"><a href="#amp-总结" class="headerlink" title="&amp;总结"></a>&amp;总结</h2>

    这样看来，”#amp-总结”才是正确跳转。

  • 若大小写原因，关闭MarkdownAllinOne扩展的自动转换小写选项
    去扩展设置里关闭。

    mdPlugin2.PNG

    （！这不是必须的，只是为了方便，顺便关闭自动更新目录）

    mdPlugin1.PNG

总结

关键还得搞清楚Hexo生成的是静态页面这个大方向，然后根据自己想法发挥。

Log HexoMarkdown