Typora插件自定义文件模板配置指南

Typora插件自定义文件模板配置指南

在Typora插件obgnail/typora_plugin中，文件模板功能为用户提供了快速创建标准化文档的便捷方式。本文将详细介绍如何配置和使用这一功能。

模板配置基础

模板配置通过修改custom_plugin.user.toml文件实现，该文件位于插件的设置目录中。每个模板由两部分组成：

• name：模板的显示名称，用于在界面中识别
• text：模板的实际内容，支持多种变量替换

可用模板变量

系统提供了丰富的变量供模板使用，包括：

• 时间相关：{{date}}(当前日期)、{{time}}(当前时间)、{{weekday}}(星期几)、{{datetime}}(完整日期时间)
• 日期计算：{{yesterday}}(昨天日期)、{{tomorrow}}(明天日期)
• 随机性：{{random}}(随机数)、{{uuid}}(唯一标识符)
• 文档相关：{{title}}(文档标题)、{{folder}}(所在目录)、{{filepath}}(文件路径)
• 选区内容：{{range}}(当前选中的文本)

模板配置示例

以下是两个实用的模板配置示例：

1. 标准文档模板：

[[templater.config.template]]
name = "标准模板"
text = """---
title: {{title}}
date: {{date}}
tags:
---

"""

2. 日记模板：

[[templater.config.template]]
name = "日记"
text = """---
title: {{title}}
date: {{date}} {{weekday}}
---

"""

高级使用技巧

1. 多模板组合：可以配置任意数量的模板，只需重复添加[[templater.config.template]]块即可。

2. 变量组合：可以将多个变量组合使用，如{{date}} {{time}}会生成类似"2024-04-17 14:30"的内容。

3. Markdown兼容：模板内容完全支持Markdown语法，可以包含标题、列表、代码块等元素。

4. 元数据支持：建议在模板中使用YAML front matter(以---包裹的部分)来存储文档元数据，这与许多静态网站生成器的惯例一致。

最佳实践建议

1. 为不同类型的文档创建专用模板，如技术文档、会议记录、读书笔记等。

2. 在团队协作中，可以共享模板配置文件来保持文档风格一致。

3. 定期备份模板配置文件，防止意外丢失。

4. 对于复杂模板，可以考虑先在小范围测试后再正式使用。

通过合理配置文件模板，可以显著提升在Typora中的文档创作效率，特别是对于需要频繁创建类似结构文档的用户来说，这一功能尤为实用。