• Lightweight markup languages are inadequate for technical writing
• A good markup language is resilient against failure
• Short-form content doesn’t need to be written as a chronological sequence of blog posts
• URLs and paths require special word-breaking rules
• A good hyperlink has enough context to work around broken URLs
• Build flexible supersets on top of Markdown
• Tips to improve my technical writing