如何巧用文档链接

简单的文档链接

直接从 MarkEditor 的左侧拖入其它文档,即可创建简单的文档链接,其语法仍然是普通的 Markdown 语法,类似 [显示的文本](/hello_world.md)

如下图,具体路径的时候,也可以右键点击,选择“插入路径”:

点击具体的链接时,MarkEditor 会自动打开对应的路径的文档,在新打开的文档中,右键点击,可以选择 “打开上篇文章” 跳转回来。

注意: 链入的文档路径,必须跟当前正在编辑的文档处于相同的工作目录下。

兼顾网站 URL 的文档链接

假设有一篇文章,为 hello.md,其最终在网站上被访问的 URL 为 http://yourdomain.com/read/my_hello_page,如果只是创建简单的文档链接,则会导致 URL 失效,因为 http://yourdomain.com/hello.md 是不可访问的。
这个时候,应该在 hello.md 中使用 metadata 的声明,指定一个 doc_url,类似下文:

title: 我是标题
doc_url:  /read/my_hello_page
这是正文~

那么,最终拖入这个文档时候,构建的文本则是 [我是标题](/read/my_hello_page?path=/hello.md),其 URL 通过 GET 参数的方式,将当前文档的路径进行了声明,这样 MarkEditor 就能处理文档间的跳转了,同时也不影响最终网站上访问的 URL。

2018-05-12 23:04
Comments
Write a Comment