我正在尝试编写一个 Markdown 文档,其中包含类似集中指定的占位符变量的内容,该变量允许将某个文本片段传播到文档的不同位置,例如
placeholder = markdown files
This is my text about %placeholder%. %placeholder% should be used by everyone.
不幸的是,经过一番研究,我没有找到实现这种行为的方法。
我知道 Markdown 的参考样式链接功能。然而,从我的角度来看,它似乎并没有完全解决我面临的问题。此外,https://www.brianchildress.co/variables-in-markdown/描述了一种完全适合我的问题的方法。但是,所提供的演示代码中的变量
random value
在文本中并未被替换。
我很高兴收到任何建议或至少暗示所请求的功能不可用。
那篇博文完全是错误的。引用样式链接不是变量,并且它们的行为与此处描述的不同。
Markdown 的指导原则之一是文件应以其源形式可读:
然而,可读性是最重要的。 Markdown 格式的文档应该可以按原样以纯文本形式发布,而不会看起来像是用标签或格式说明进行了标记。
占位符与该原则相冲突,因此不包含在 Markdown 中。
这个答案关于堆栈溢出的类似问题,可以轻松地在基于 HTML 的 Markdown 应用程序中创建所需的行为,而无需任何附加组件或复杂的编码,但会降低源表单的可读性。因此,正如 Chris 指出的那样,这也违背了 Markdown 指导原则。
也许有一天我可能会为可能满足准则的变量创建一个 Markdown 插件。它有时在某些模板中是有意义的。例如,在法律文件中,有时类似的事情是这样完成的:
Oolong Johnson (hereinafter "Client")
,然后在文件中到处只写Client
,而不是写出整个名称。这保留了可读性,但读者必须在头脑中进行替换。一个附加组件可以进行替换。可读的定义和占位符可能类似于 [Client]-is: Oolong Johnson
和 [Client]
。在渲染时,定义将被隐藏,每次出现的 [Client]
都将替换为 Oolong Johnson
。这将像法律文档一样可读,虽然不是很好,但确实有效,并且与参考样式链接的工作方式类似。