IELTS Dictation Test

IELTS Dictation Test is an Obsidian plugin for vocabulary dictation practice. It renders interactive dictation blocks from Markdown, plays word audio, lets learners type freely in one large text box, grades answers automatically, saves the last submitted result, and can append wrong words to a chapter mistake book.

The plugin was designed for IELTS vocabulary notes, but the block format also works for any English vocabulary list.

中文简介

IELTS Dictation Test 是一个 Obsidian 英语词汇听写插件。它可以在笔记中渲染听写模块，支持本地音频朗读、自由文本框输入、自动批改、保存上次提交结果，并把错词追加到章节错题本。

它只提供学习交互能力，不包含任何课程 PDF、视频、音频、词典数据或第三方教材内容。

Features

• Render ielts-dictation code blocks inside notes.
• Play individual word audio or run a full dictation sequence.
• Adjust playback speed.
• Type answers freely in one textarea instead of fixed one-line inputs.
• Grade continuous answers with missing-word handling.
• Treat hyphen variants as equivalent, for example eco-friendly, eco friendly, and ecofriendly.
• Save the last input and submitted result for each dictation block.
• Reset a block to clear saved state.
• Add wrong words to a chapter mistake book.
• Add selected text to the chapter mistake book from a command or ribbon button.

Install Manually

1. Download main.js, manifest.json, and styles.css from a release.

2. Create this folder in your vault:

   .obsidian/plugins/ielts-dictation-test/
   

3. Put the three files into that folder.

4. Restart Obsidian or reload plugins.

5. Enable IELTS Dictation Test in Settings -> Community plugins.

Usage

Create a code block like this:

```ielts-dictation
id: ch2-check-01
title: Stage Vocabulary Dictation 01
time: 01:06-06:20
audioBase: 40 Resources/IELTS/audio/ch2-check-01/
words:
  - herbs | 香草；草本植物 | herbs.mp3
  - botanist | 植物学家 | botanist.mp3
  - eco-friendly | 环保的；生态友好的 | eco-friendly.mp3
  - user-friendly | 用户友好的；容易使用的 | user-friendly.mp3
  - genetics | 遗传学 | genetics.mp3
  - gene | 基因 | gene.mp3
  - hybrid car | 混合动力汽车 | hybrid-car.mp3
  - ecosystem | 生态系统 | ecosystem.mp3
```

The word line format is:

- answer / alternative answer | Chinese meaning | audio file name

For example:

- hydro power / hydropower | 水力发电 | hydro-power.mp3

Mistake Book

When a wrong answer is added to the mistake book, the plugin creates a compact learning entry:

### genetics

- 中文：遗传学
- 我的输入：空
- 正确答案：genetics
- 来源：[[2.0 植物保护]] · Stage Vocabulary Dictation 01（01:06-06:20） · 第 5 词
- 延展：
  > Context found from the source note.

For a chapter note named 2.0 植物保护.md, the mistake book path is automatically inferred as 2.1 植物保护错题本.md.

Notes

• Audio files are local vault files. The plugin does not ship any dictionary data, course material, or audio.
• Dictation state is saved in local storage and is cleared only when you click Reset.
• The plugin currently has Chinese UI text because it was built for Chinese IELTS learners.

Release Files

For Obsidian installation, a GitHub release should include:

• main.js
• manifest.json
• styles.css

The repository also includes versions.json for Obsidian version compatibility metadata.

License

MIT