Markdown is a minimal way to format your text. The goal is to use "natural" formats, similar to email. Software that understands Markdown translates it to HTML. Markdown is much easier--and more forgiving--than HTML. This post has the markdown you'll use the most. The rest of the features are explored later.
The full spec is hosted by its creator, Jon Gruber
Using Markdown Here at Dreamwidth
You can use Markdown for new posts and when you reply by email. Right now, you can't use Markdown on the website when you're replying to posts (aka commenting on entries).
Now Dreamwidth interprets any Markdown you type. By definition, Markdown includes HTML, so you can also use HTML to format your post—for Dreamwidth cuts, image embeds, and any other HTML task.
Bold, strong, italic, emphasis
Begin and end text with either _ underscore or * asterisk
Use ONE for emphasis aka italic
Use TWO for strong aka bold
The *rain* in _Spain_ falls *mainly* on _the Plain_.
I **think** she's __got it__, she's **finally** got __IT__!
The rain in Spain falls mainly on the Plain. I think she's got it, she's finally got IT!
Prefix the account with an "@" sign
@jesse_the_k ⇒ jesse_the_k
@access_fandom ⇒ access_fandom
@dw_news ⇒ dw_news
For other sites, use the format @username.site
@jesse_the_k.ao3 ⇒ jesse_the_k
@jesse-the-k.tumblr ⇒ jesse-the-k
@jesse_the_k.twitter ⇒ jesse_the_k
Bullet lists begin and end with a blank line - then any number of lines that - begin with a hyphen - and a space - like this one must have a blank line to turn off the list
Bullet lists begin and end with a blank line
- then any number of lines
- that begin with a hyphen
- and a space
- like this one
must have a blank line to turn off the list
Numbered lists (called ordered lists <ol> in HTML) use digits instead of hyphens. The presence of a digit and a period is what does it:
must have a blank line 4. then any number of lines 1. that begin with a digit and 290. then a period, like this one 2. and this one 2. and so on must have a blank line to turn off numbering
must have a blank line
- then any number of lines
- that begin with a digit and
- then a period, like this one
- and this one
- and so on
must have a blank line to turn off numbering
The value of the number doesn't matter, and the list always starts at 1!
Three or more asterisks, with blank line before & after. Markdown:
[ETA: this also works with hyphens, but hyphens will end your post early when you're replying or posting by email]
Write your link text (aka anchor) in square brackets immediately followed by the URL in parentheses.
The source repository is located at [Dreamwidth's GitHub Repositories](https://github.com/
The source repository is located at Dreamwidth's GitHub Repositories.
Enclose URLs and email addresses within angle brackets and they're clickable
<https://example.com> ⇒ https://example.com/
<email@example.com> ⇒ firstname.lastname@example.org
Surround code with ` backtick
Markdown: Remember to turn on this feature by beginning your post or email with `!markdown` followed by a blank line.
Remember to turn on this feature by beginning your post or email with
!markdown followed by a blank line.