Markdown
Markdown is a lightweight plain-text markup language designed by John Gruber in 2004. It uses concise symbolic syntax—such as hash signs, asterisks, and hyphens—to annotate text formatting, which tools can then convert into HTML and other rich-text formats. Markdown is widely used in documentation, technical blogs, content management systems, and code-hosting platforms, and is characterized by its readability in both source and rendered forms.
Core Facts
skill.md is written in Markdown format and contains metadata (skill name and description) as well as detailed execution instructions.
SDD（Specification-Driven Development，规范驱动开发）是当前AI编程领域被普遍认可的一种开发思想，核心理念是基于规范驱动进行编程
Obsidian is a bidirectional-linking note-taking tool based on local Markdown files, with all data stored locally in plain text format.
Timeline (last 90 days)
The semantics of rendered Markdown are not unique to machines: the same passage of text may be parsed as display content or interpreted by a downstream LLM as structured instructions.
Markdown lacks native security mechanisms like CSP, making isolation at the parsing layer more difficult.
Security researchers recently documented an in-the-wild attack: attackers embedded malicious Markdown content in documents, and after parsing it, an AI agent misjudged it as trusted instructions and executed tool calls with full credentials without human approval.
The Markdown injection attack is not a bug in some Markdown parser, but a missing trust boundary design at the agent architecture level.
Converting raw webpage HTML into clean Markdown can remove structural noise and fit more useful information into a limited context window.
The jakubkrehel/skills project uses Markdown as its main language, and each skill is likely defined as a document containing a skill description, trigger conditions, execution steps and examples.
Compared with JSON Schema or YAML configuration, Markdown allows natural-language explanations, counterexamples and example code to be embedded in descriptions, making it better suited to expressing fuzzy rules such as "when to trigger, how to execute, and what to avoid."
Some AI tools and clients preferentially request the Markdown version rather than the rendered HTML when crawling web pages, because Markdown is clearer in structure, more token-efficient, and easier for models to parse directly.
Providing a Markdown version involves site architecture decisions, such as returning different formats at the same URL based on the Accept header through content negotiation, or maintaining a separate .md endpoint.
The togg53192-cmd/jailbreaks repository uses Markdown to organize its content, with a simple structure that is easy to search and reuse.
40 more timeline events
All Facts (20)
skill.md is written in Markdown format and contains metadata (skill name and description) as well as detailed execution instructions.
80%VerifiedSDD（Specification-Driven Development，规范驱动开发）是当前AI编程领域被普遍认可的一种开发思想，核心理念是基于规范驱动进行编程
80%VerifiedObsidian is a bidirectional-linking note-taking tool based on local Markdown files, with all data stored locally in plain text format.
80%VerifiedMarkdown is a lightweight markup language created by John Gruber in 2004.
80%Verifiedmd2pdf.py converts Markdown to styled PDF, supports headings, tables, lists and links, depends on the third-party reportlab package, and is used as python md2pdf.py content.md product.pdf "My Product Title".
75%VerifiedPrompts should be written in Markdown format because large models have a more complete understanding of Markdown syntax; their structure can be divided into four modules: role definition, skills, output examples, and constraints.
75%VerifiedMarkdown is both human-readable and easy for large language models to parse, meeting the needs of both human authoring and machine reading.
75%VerifiedMarkdown is a lightweight markup language with concise syntax, strong readability, and ease of version management, and has become the de facto standard format for technical documentation.
70%VerifiedLarge language models encountered a large volume of Markdown-formatted text from sources such as GitHub, technical documentation, and Wikipedia during the pre-training phase, and therefore have an extremely strong understanding of Markdown structure.
70%VerifiedMarkdown is the default document format for mainstream platforms such as GitHub, Notion, and Obsidian, and is also the default output format for nearly all large language models.
70%VerifiedMarkdown is a lightweight markup language that uses symbols such as # for headings and ** for bold to accomplish text formatting.
65%VerifiedAI Agent observability has evolved from the three pillars of traditional software—logs, metrics, and traces—with the addition of new dimensions such as token consumption, prompt versioning, tool call chains, reasoning path branching, and context window occupancy.
65%VerifiedSkills files typically contain YAML front matter (for trigger condition evaluation) and Markdown body text (for defining workflows and output specifications).
65%VerifiedOpenAI's GPT series models are particularly friendly to Markdown format, because they were extensively exposed to code and documentation on GitHub—primarily in Markdown format—during training.
65%VerifiedHTML output allows AI to embed SVG charts, interactive components, in-page navigation, color coding, and inline annotations—features that Markdown cannot achieve.
65%VerifiedMarkdown is the standard format for platforms such as GitHub, Stack Overflow, and Notion.
65%UnverifiedMarkdown作为纯文本格式与Git的diff机制完美兼容，而HTML文件由于包含大量标签和样式代码，使得代码审查变得极其困难
90%UnverifiedHTML输出比Markdown消耗明显更多的Token，一个简单的加粗文字在Markdown中需要6个额外字符，而在HTML中需要17个额外字符
90%UnverifiedHTML的diff极其嘈杂难以审查，是HTML替代Markdown的最大缺点
85%UnverifiedMarkdown的结构化标题层级天然对应需求文档的章节层次，且对大模型友好，token利用率高于HTML等富格式文本
80%