Markdown 语法

    代码块

    其中,language 为必填,如果不填写,很可能主题的代码高亮插件无法识别代码的语言,导致样式异常。举几个例子:

    1. ```java
    2. public static void main(String[] args){
    3. System.out.println("Hello World!");
    4. }
    5. ```
    1. ```javascript
    2. console.log("Hello World!")
    3. ```

    在文章的最前面加上 [TOC] 即可。

    自动链接

    支持自动将一个链接解析为可点击的格式,如下:

    1. https://halo.run

    将被解析为:

      支持将 Emoji 的文字形式转化为图片形式,如下:

      1. :100:

      将被解析为:

      更多 Emoji 表情可访问:https://emoji.svend.cc

      数学公式

      行内公式:

      1. $a \ne 0$
      1. $$
      2. x = {-b \pm \sqrt{b^2-4ac} \over 2a}.
      3. $$

      Q&A:

      Q:编辑器可以显示公式,为啥发布之后前台看不了?你这不是瞎写吗?

      A:不是!你需要知道的是,并不是所有主题都支持显示公式。这时候,你就需要自己添加解析插件了。

      Q:那是要我改代码吗?改 Halo 还是主题?这我也不会啊?那怎么办?你能帮帮我吗?

      A:别老想去改代码了。添加的方法很简单:

      首先,登陆到后台,进入 系统 -> 博客设置 -> 其他设置。将下面的代码复制到 。

      1. <script src="//cdn.jsdelivr.net/npm/[email protected]/unpacked/MathJax.js?config=TeX-MML-AM_CHTML" defer></script>
      2. <script>
      3. document.addEventListener('DOMContentLoaded', function () {
      4. MathJax.Hub.Config({
      5. 'HTML-CSS': {
      6. matchFontHeight: false
      7. },
      8. SVG: {
      9. matchFontHeight: false
      10. },
      11. CommonHTML: {
      12. matchFontHeight: false
      13. },
      14. tex2jax: {
      15. ['$','$'],
      16. ],
      17. displayMath: [["$$", "$$"], ["\\[", "\\]"]]
      18. }
      19. });
      20. });
      21. </script>

      饼图:

      1. ```mermaid
      2. pie title NETFLIX
      3. "Time spent looking for movie" : 90
      4. "Time spent watching it" : 10
      5. ```

      更多用法查看:

      Q:同上,这也是编辑器可显示,前台显示不了啊?

      A:添加插件的方法和上面的一样:

      首先,登陆到后台,进入 系统 -> 博客设置 -> 其他设置。将下面的代码复制到 自定义内容页面 head

      1. <script src="https://cdn.jsdelivr.net/npm/[email protected]/dist/mermaid.min.js"></script>

      短连接

      Halo 内置一些短连接以更好地支持一些 HTML 语法,但是编辑器目前并不能解析,只能发布之后才可以看到效果,如下:

      示例:

      1. <iframe frameborder="no" border="0" marginwidth="0" marginheight="0" width=330 height=86 src="//music.163.com/outchain/player?type=2&id=32507038&auto=1&height=66"></iframe>

      将被解析为:

      1. <iframe frameborder="no" border="0" marginwidth="0" marginheight="0" width=330 height=86 src="//music.163.com/outchain/player?type=2&id=32507038&auto=1&height=66"></iframe>

      哔哩哔哩动画

      1. [bilibili:aid,width,height]

      示例:

      将被解析为:

      1. <iframe height="256" width="256" src="//player.bilibili.com/player.html?aid=65898131" scrolling="no" border="0" frameborder="no" framespacing="0" allowfullscreen="true"> </iframe>