Markdown 中文本片段的占位符变量

问题描述 投票:0回答:2

我正在尝试编写一个 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
在文本中并未被替换。

我很高兴收到任何建议或至少暗示所请求的功能不可用。

variables text replace markdown placeholder
2个回答
4
投票

那篇博文完全是错误的。引用样式链接不是变量,并且它们的行为与此处描述的不同。

Markdown 的指导原则之一是文件应以其源形式可读

然而,可读性是最重要的。 Markdown 格式的文档应该可以按原样以纯文本形式发布,而不会看起来像是用标签或格式说明进行了标记。

占位符与该原则相冲突,因此不包含在 Markdown 中。


0
投票

这个答案关于堆栈溢出的类似问题,可以轻松地在基于 HTML 的 Markdown 应用程序中创建所需的行为,而无需任何附加组件或复杂的编码,但会降低源表单的可读性。因此,正如 Chris 指出的那样,这也违背了 Markdown 指导原则。

也许有一天我可能会为可能满足准则的变量创建一个 Markdown 插件。它有时在某些模板中是有意义的。例如,在法律文件中,有时类似的事情是这样完成的:

Oolong Johnson (hereinafter "Client")
,然后在文件中到处只写
Client
,而不是写出整个名称。这保留了可读性,但读者必须在头脑中进行替换。一个附加组件可以进行替换。可读的定义和占位符可能类似于
[Client]-is: Oolong Johnson
[Client]
。在渲染时,定义将被隐藏,每次出现的
[Client]
都将替换为
Oolong Johnson
。这将像法律文档一样可读,虽然不是很好,但确实有效,并且与参考样式链接的工作方式类似。

© www.soinside.com 2019 - 2024. All rights reserved.