markdown中命名锚一文中描述了在markdown文本中嵌入HTML代码来命名锚,但是总觉得HTML+markdown在一起较别扭。最近了解了pandoc,发现pandoc‘s markdown中headers一节有这种功能描述, 记录如下。

定义Header的identifier如下:

1
##My Header## {#foo}

这样我们在创建文章目录索引时,可以如下创建链接:

1
[My Header](#foo)

这样比使用HTML命名锚更加简单,看起来更加简洁了。

另外,如果是使用pandoc's markdown写博客且使用hexo部署,则需要安装hexo-renderer-pandoc插件.


我的博客: http://liumh.com

Comment and share

本文记录的是如何使用markdown命名锚(names anchors),当使用命名锚时,我们可以创建文章目录,直接跳至该命名锚(比如页面中某个小节)的链接,这样使用者就无需不停地滚动页面来寻找他们需要的信息了。

其实使用markdown不能直接达到定义命名锚的目的,借助了html的功能。在定义标题时不使用markdown语法(#个数对应相应级别的HTML样式标题),而使用h1/h2等,且使用id属性命名锚,如:

Continue reading
  • page 1 of 1
Author's picture

CaryaLiu

@Chengdu


iOS Developer


Chengdu