Dungeons & Markdown
Generate D&D style documents from Markdown
A VS Code extension based on Homebrewery
Dungeons & Markdown
Generate beautiful D&D style documents with Markdown.
Based on Homebrewery V3, regular Markdown syntax is supported, but also extended with a range of useful options. For convenience, most of this extended syntax is provided as 32 example snippets bundled with this extension.
Below are descriptions of these snippets and examples of what they can generate.
Source markdown for this document is available here
Using snippets
When editing a Markdown document, press CTRL+Space or the assigned auto-complete hotkeys for a list of options. All Dungeons & Markdown snippets are prefixed with dnm-, e.g. dnm-class-table.
The snippets roughly match the options presented in the Homebrewery web editor, but will generate the same output whenever used, whereas the web editor has a range of random content for each element.
Images
All images can be modfied to change size, location and opacity, using css-style properties.
Snippets
| Command | Effect |
|---|---|
| dnm-image | Add an image |
| dnm-background-image | Add a background image |
| dnm-watermark | Add a watermark text |
| dnm-waterstain | Add a water stain or splatter |
dnm-image
Images are added in-line and can be decorated with caption and artist credits
Cat Warrior
dnm-background-image
Background images will allow content on top. Make sure to consider text and image location to ensure readablility.
dnm-watermark
Watermark text will be calpitalized and positioned diagonally across the whole page. Avoid words with more than roughly 10 letters to avoid multiple lines of text.
WATERMARKdnm-waterstain
Add a waterstain or splotch as a background image. Shapes are predefined but can be resized as any other image.
There are 12 shapes available, named watercolorX where X is between 1 and 12.
1
Snippets | Images
Player's Handbook Elements
These elements mimic the look and feel of the Player's Handbook
Snippets
| Command | Effect |
|---|---|
| dnm-note | Add a framed text box |
| dnm-descriptive-text | Add a highlighted text box |
| dnm-cover-page | Add a front cover page |
| dnm-magic-item | Add a item details block |
| dnm-spell | Add a spell details block |
| dnm-spell-list | Add a list of spells |
| dnm-class-features | Add a list of class features |
| dnm-monster-stat-block | Add a monster details block |
| dnm-monster-stat-block-framed | Add a framed monster details block |
| dnm-monster-stat-block-wide | Add a page-wide monster details block |
Examples
Coming soon.. Snippets | Player's Handbook Elements
Tables
Additional D&D style tables are available, beyond generic Markdown tables syntax
Snippets
| Command | Effect |
|---|---|
| dnm-table | Add a default styled table |
| dnm-table-wide | Add a default styled wide table |
| dnm-table-split | Add a table split into 2 or more columns |
| dnm-table-class | Add a class details table |
| dnm-table-class-framed | Add a framed class details table |
| dnm-table-class-half | Add a half sized class details table |
| dnm-table-class-half-framed | Add a framed half size class details table |
Examples
Coming soon.. Snippets | Tables
Text Edit Elements
These snippets make it possible to lay out the pages easier than with generic Markdown
Snippets
| Command | Effect |
|---|---|
| dnm-column | Add a column break |
| dnm-page | Add a page break |
| dnm-spacing-vertical | Add vertical spacing |
| dnm-spacing-horizontal | Add horizontal spacing |
| dnm-text-wide | Add text and content box in full page width |
| dnm-page-number | Add specific page number and footnote |
| dnm-page-auto | Add auto-increment page number and footnote |
| dnm-page-link | Add link to specific page number |
| dnm-qr | Add QR code |
| dnm-toc | Add Table of Contents (not auto-generated) |
Examples
Coming soon.. Snippets | Text Edit Elements