---
title: 'Grav DDD Plugin'
url: 'https://www.twelvetone.tv/docs/developer-tools/grav-plugins/grav-ddd-plugin'
markdown: 'https://www.twelvetone.tv/docs/developer-tools/grav-plugins/grav-ddd-plugin.md'
date: '2026-09-25'
description: 'A plugin for Document Driven Design (DDD). Overvi'
taxonomy:
  devtype:
    - beta
  category:
    - docs
---

[](#)  [ Home ](https://www.twelvetone.tv/docs/)     [ Developer Tools ](https://www.twelvetone.tv/docs/developer-tools)     [ Grav Plugins ](https://www.twelvetone.tv/docs/developer-tools/grav-plugins)      Grav DDD Plugin    

# Grav DDD Plugin

This product is in *beta state*. 
It is available to registered beta testers only.

A plugin for Document Driven Design (DDD).

# Overview

Document Driven Design takes the concept of Test Driven Design, and adds these mindsets:

- Documentation should be written before tests.
- Documentation should be separated from source code.
- Documentation should be targeted for specific users. 
    - Developers
    - Implementors
    - End Managers
    - End Users
    - Purchasers
- Round Trip Documentation
- Integrate Usage, Bugs, Features, Tasks, and Roadmaps

# Markdown

To add DDD into markdown

- Start a line with a tilde
- Followed by the DDD entry type
- Followed by DDD entry fields
- Ending with a tilde.

```
 ~entry_type entry_fields content~
```

Each DDD entry type has different field requirements.

# Sample Markdown Output

```
 ~task This is a task~
 ~todo This is a todo~
 ~feature This is a feature~
 ~bug priority:5 This is a bug~
 ~roadmap release:next This is a roadmap item ~
```

task: This is a task

todo: This is a todo

feature: This is a feature

bug: This is a bugpriority:5

roadmap: This is a roadmap item release:next

 [ ](https://www.twelvetone.tv/docs/developer-tools/grav-plugins/grav-softsite-plugin) [](https://www.twelvetone.tv/docs/developer-tools/npm-modules)

---

## Navigation

- Parent: [Grav Plugins](https://www.twelvetone.tv/docs/developer-tools/grav-plugins.md)
- Previous: [Grav SoftSite Plugin](https://www.twelvetone.tv/docs/developer-tools/grav-plugins/grav-softsite-plugin.md)