用markdown写博的几点注意

不是 Typora 工具栏里的那些常规操作!

书写软件用的是 Typora,写作过程中遇到的需要注意的点:

特殊符号的转译

使用\即可,比如需要在网页上完整显示 _config.yml 配置,需要在_前用\

锚点的书写

1
2
<a href="#target">从这里跳转</a>
<a name="target">跳转到这里</a>

换行只换一行

默认的enter键是换两行,只换一行的操作是Shift+enter键。

首行缩进两格

&nbsp;&emsp;&ensp;这三个都没有达到想要的效果,用下面代码即可。

1
<p style="text-indent:2em">你的内容</p>

图片并排显示

  1. 用 figure 标签

    1
    2
    3
    4
    5
    6
    7
    <!-- 用的是figure标签 -->
    <!-- markdown显示正常,该博客框架主题下显示异常-->
    <figure class="third">
    <img src="https://cdn.jsdelivr.net/gh/xgyxss/picgo@main/img/hexo/github-avatar.jpeg" width="200" height="200" align=left>
    <img src="https://cdn.jsdelivr.net/gh/xgyxss/picgo@main/img/hexo/github-avatar.jpeg" width="200" height="200" align=left>
    <img src="https://cdn.jsdelivr.net/gh/xgyxss/picgo@main/img/hexo/github-avatar.jpeg" width="200" height="200" align=left>
    </figure>
  2. |分隔符

    1
    2
    3
    4
    # 简单来说,就是用|将img标签分隔开
    # markdown显示正常,该博客框架主题下显示异常
    ![图二](ur1)|![图二](url)|![图二](ur1)|![图二](ur1)
    ---|---|---|---
  3. 通过table标签解决:

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    <table style="border:none;">
    <tr style="border:none;">
    <th style="border:none;">左边</th>
    <th style="border:none;">右边</th>
    </tr>
    <tr style="border:none;">
    <td style="border:none;"><img src="https://cdn.jsdelivr.net/gh/xgyxss/picgo@main/img/hexo/github-avatar.jpeg" width="200" height="200" /></td>
    <td style="border:none;"><img src="https://cdn.jsdelivr.net/gh/xgyxss/picgo@main/img/hexo/github-avatar.jpeg" width="200" height="200" /></td>
    </tr>
    </table>
    左边 右边

多级有序列表渲染失败

详见写博查阅文档这篇文章中的有序列表,可以看到渲染失败的案例。

两个相连序号间也没有空行,唯一有嫌疑的就是之间插入了 iframe,在 Typora 直接显示的是空白,可能是将此判断成了空行,导致有序列表渲染失败。

文章作者: 夜行书生
文章链接: https://yexingshusheng.com/2022/03/yong-markdown-xie-bo-de-ji-dian-zhu-yi.html
版权声明: 本博客所有文章除特别声明外,均采用 CC BY-NC-SA 4.0 许可协议。转载请注明来自 夜行书生