···19192020Donec nibh risus, porta ut turpis quis, maximus ornare neque. Integer elementum, libero nec venenatis egestas, ante neque accumsan dolor, non semper dui augue sit amet sem. Mauris faucibus, orci at pellentesque mollis, nunc dolor dapibus lacus, id iaculis est lectus a urna. Maecenas rutrum cursus lectus sit amet hendrerit. Duis purus quam, scelerisque in eros ut, egestas iaculis nunc. Nam consequat nisl non mauris bibendum, vitae consequat odio sodales. Vestibulum porttitor, mi a interdum tristique, turpis augue faucibus tortor, sed tincidunt ligula eros at urna.
21212222-Etiam porttitor, lorem quis consectetur cursus, urna sem molestie ipsum, sit amet condimentum magna sapien eu leo. Sed vel consequat felis. Lorem ipsum dolor sit amet, consectetur adipiscing elit. Quisque sit amet odio id augue finibus molestie. Vivamus ut odio luctus, pharetra purus sed, venenatis enim. Nam laoreet leo vel sollicitudin lacinia. Praesent mollis dignissim justo ac aliquam. Suspendisse volutpat nisl eget blandit tincidunt. Praesent hendrerit quis tellus sodales condimentum. Morbi rhoncus, felis vitae sollicitudin sodales, nisi justo fringilla nibh, a ultrices arcu enim non leo. Maecenas mollis neque nec odio malesuada suscipit. In vel quam turpis. Quisque a nisi urna. Nunc ut tellus sit amet mauris condimentum ultricies quis in nulla.
2222+Etiam porttitor, lorem quis consectetur cursus, urna sem molestie ipsum, `sit amet condimentum magna sapien` eu leo. Sed vel consequat felis. Lorem ipsum dolor sit amet, consectetur adipiscing elit. Quisque sit amet odio id augue finibus molestie. Vivamus ut odio luctus, pharetra purus sed, venenatis enim. Nam laoreet leo vel sollicitudin lacinia. Praesent mollis dignissim justo ac aliquam. Suspendisse volutpat nisl eget blandit tincidunt. Praesent hendrerit quis tellus sodales condimentum. Morbi rhoncus, felis vitae sollicitudin sodales, nisi justo fringilla nibh, a ultrices arcu enim non leo. Maecenas mollis neque nec odio malesuada suscipit. In vel quam turpis. Quisque a nisi urna. Nunc ut tellus sit amet mauris condimentum ultricies quis in nulla.
23232424Donec eu consequat elit, sed vehicula lorem. Integer vel leo eget sem auctor ultricies. Etiam consequat ultrices ultricies. Quisque nec risus nulla. In molestie, ligula nec fringilla tincidunt, dui magna consequat sapien, non interdum felis nulla in odio. Etiam non dolor semper, feugiat ante pretium, varius elit. Nam a tortor at lorem ultrices tincidunt. Suspendisse neque quam, luctus et diam sed, viverra accumsan leo. Cras eu lacus blandit, vulputate leo porta, pellentesque quam. Aenean ullamcorper ex ac finibus tincidunt. Etiam sit amet massa cursus metus bibendum aliquam. Quisque pulvinar tincidunt nisi, et ornare ligula dictum at.
2525
+497
content/notes/markdown-overview.smd
···11+---
22+.title = "Markdown Overview",
33+.author = "Jakob Speer",
44+.date = @date("2025-07-22"),
55+.layout = "root.shtml",
66+.draft = false,
77+.description = "A small overview of Markdown features supported by this site"
88+---
99+1010+Learn how to apply basic formatting to your notes, using [Markdown](https://daringfireball.net/projects/markdown/). For more advanced formatting syntax, refer to [Advanced formatting syntax](https://help.obsidian.md/advanced-syntax).
1111+1212+## Paragraphs
1313+1414+To create paragraphs in Markdown, use a **blank line** to separate blocks of text. Each block of text separated by a blank line is treated as a distinct paragraph.
1515+1616+```md
1717+This is a paragraph.
1818+1919+This is another paragraph.
2020+```
2121+2222+This is a paragraph.
2323+2424+This is another paragraph.
2525+2626+A blank line between lines of text creates separate paragraphs. This is the default behavior in Markdown.
2727+2828+Multiple blank spaces
2929+3030+Multiple adjacent blank spaces within and between paragraphs collapse into a single space when displayed in [Reading view](https://help.obsidian.md/edit-and-read#Reading%20view) or on [Obsidian Publish](https://help.obsidian.md/publish) sites.
3131+3232+```md
3333+Multiple adjacent spaces
3434+3535+and multiple newlines between paragraphs.
3636+```
3737+3838+> Multiple adjacent spaces
3939+>
4040+> and multiple newlines between paragraphs.
4141+4242+If you want to prevent spaces from collapsing or add multiple blank spaces, you can use the ` ` (non-breaking space) or `<br>` (line break) HTML tags.
4343+4444+### Line breaks
4545+4646+By default in Obsidian, pressing `Enter` once will create a new line in your note, but this is treated as a *continuation* of the same paragraph in the rendered output, following typical Markdown behavior. To insert a line break *within* a paragraph without starting a new paragraph, you can either:
4747+4848+- Add **two spaces** at the end of a line before pressing `Enter`, or
4949+- Use the shortcut `Shift + Enter` to directly insert a line break.
5050+5151+Why don't multiple `Enter` presses create more line breaks in reading view?
5252+5353+Obsidian includes a **Strict Line Breaks** setting, which makes Obsidian follow the standard Markdown specification for line breaks.
5454+5555+To enable this feature:
5656+5757+1. Open **Settings**.
5858+2. Go to the **Editor** tab.
5959+3. Enable **Strict Line Breaks**.
6060+6161+When **Strict Line Breaks** is enabled in Obsidian, line breaks have three distinct behaviors depending on how the lines are separated:
6262+6363+**Single return with no spaces**: A single `Enter` with no trailing spaces will combine the two separate lines into a single line when rendered.
6464+6565+```md
6666+line one
6767+line two
6868+```
6969+7070+Renders as:
7171+7272+line one line two
7373+7474+**Single return with two or more trailing spaces**: If you add two or more spaces at the end of the first line before pressing `Enter`, the two lines remain part of the same paragraph, but are broken by a line break (HTML `<br>` element). We'll use two underscores to stand in for spaces in this example.
7575+7676+```md
7777+line three__
7878+line four
7979+```
8080+8181+Renders as:
8282+8383+line three
8484+8585+line four
8686+8787+**Double return (with or without trailing spaces)**: Pressing `Enter` twice (or more) separates the lines into two distinct paragraphs (HTML `<p>` elements), regardless of whether you add spaces at the end of the first line.
8888+8989+```md
9090+line five
9191+9292+line six
9393+```
9494+9595+Renders as:
9696+9797+line five
9898+9999+line six
100100+101101+## Headings
102102+103103+To create a heading, add up to six `#` symbols before your heading text. The number of `#` symbols determines the size of the heading.
104104+105105+```md
106106+# This is a heading 1
107107+## This is a heading 2
108108+### This is a heading 3
109109+#### This is a heading 4
110110+##### This is a heading 5
111111+###### This is a heading 6
112112+```
113113+114114+## This is a heading 1
115115+116116+## This is a heading 2
117117+118118+### This is a heading 3
119119+120120+#### This is a heading 4
121121+122122+##### This is a heading 5
123123+124124+###### This is a heading 6
125125+126126+## Bold, italics, highlights
127127+128128+Text formatting can also be applied using [Editing shortcuts](https://help.obsidian.md/editing-shortcuts).
129129+130130+| Style | Syntax | Example | Output |
131131+| --- | --- | --- | --- |
132132+| Bold | `** **` or `__ __` | `**Bold text**` | **Bold text** |
133133+| Italic | `* *` or `_ _` | `*Italic text*` | *Italic text* |
134134+| Strikethrough | `~~ ~~` | `~~Striked out text~~` | ~~Striked out text~~ |
135135+| Highlight | `== ==` | `==Highlighted text==` | ==Highlighted text== |
136136+| Bold and nested italic | `** **` and `_ _` | `**Bold text and _nested italic_ text**` | **Bold text and *nested italic* text** |
137137+| Bold and italic | `*** ***` or `___ ___` | `***Bold and italic text***` | ***Bold and italic text*** |
138138+139139+Formatting can be forced to display in plain text by adding a backslash `\` in front of it.
140140+141141+\*\*This line will not be bold\*\*
142142+143143+```markdown
144144+\*\*This line will not be bold\*\*
145145+```
146146+147147+\* *This line will be italic and show the asterisks* \*
148148+149149+```markdown
150150+This line will be italic and show the asterisks
151151+```
152152+153153+## Internal links
154154+155155+Obsidian supports two formats for [internal links](https://help.obsidian.md/links) between notes:
156156+157157+- Wikilink: `[[Three laws of motion]]`
158158+- Markdown: `[Three laws of motion](Three%20laws%20of%20motion.md)`
159159+160160+## External links
161161+162162+If you want to link to an external URL, you can create an inline link by surrounding the link text in brackets (`[ ]`), and then the URL in parentheses (`( )`).
163163+164164+```md
165165+[Obsidian Help](https://help.obsidian.md)
166166+```
167167+168168+[Obsidian Help](https://help.obsidian.md/)
169169+170170+You can also create external links to files in other vaults, by linking to an [Obsidian URI](https://help.obsidian.md/Extending+Obsidian/Obsidian+URI).
171171+172172+```md
173173+[Note](obsidian://open?vault=MainVault&file=Note.md)
174174+```
175175+176176+### Escape blank spaces in links
177177+178178+If your URL contains blank spaces, you must escape them by replacing them with `%20`.
179179+180180+```md
181181+[My Note](obsidian://open?vault=MainVault&file=My%20Note.md)
182182+```
183183+184184+You can also escape the URL by wrapping it with angled brackets (`< >`).
185185+186186+```md
187187+[My Note](<obsidian://open?vault=MainVault&file=My Note.md>)
188188+```
189189+190190+## External images
191191+192192+You can add images with external URLs, by adding a `!` symbol before an [external link](https://help.obsidian.md/syntax#External%20links).
193193+194194+```md
195195+
196196+```
197197+198198+
199199+200200+You can change the image dimensions, by adding `|640x480` to the link destination, where 640 is the width and 480 is the height.
201201+202202+```md
203203+
204204+```
205205+206206+If you only specify the width, the image scales according to its original aspect ratio. For example:
207207+208208+```md
209209+
210210+```
211211+212212+> # [Tip]($block)
213213+> If you want to add an image from inside your vault, you can also [embed an image in a note](https://help.obsidian.md/embeds#Embed%20an%20image%20in%20a%20note).
214214+215215+## Quotes
216216+217217+You can quote text by adding a `>` symbols before the text.
218218+219219+```md
220220+> Human beings face ever more complex and urgent problems, and their effectiveness in dealing with these problems is a matter that is critical to the stability and continued progress of society.
221221+222222+\- Doug Engelbart, 1961
223223+```
224224+225225+> Human beings face ever more complex and urgent problems, and their effectiveness in dealing with these problems is a matter that is critical to the stability and continued progress of society.
226226+227227+\- Doug Engelbart, 1961
228228+229229+Tip
230230+231231+You can turn your quote into a [callout](https://help.obsidian.md/callouts) by adding `[!info]` as the first line in a quote.
232232+233233+## Lists
234234+235235+You can create an unordered list by adding a `-`, `*`, or `+` before the text.
236236+237237+```md
238238+- First list item
239239+- Second list item
240240+- Third list item
241241+```
242242+243243+- First list item
244244+- Second list item
245245+- Third list item
246246+247247+To create an ordered list, start each line with a number followed by a `.` or `)` symbol.
248248+249249+```md
250250+1. First list item
251251+2. Second list item
252252+3. Third list item
253253+```
254254+255255+1. First list item
256256+2. Second list item
257257+3. Third list item
258258+259259+```md
260260+1) First list item
261261+2) Second list item
262262+3) Third list item
263263+```
264264+265265+1. First list item
266266+2. Second list item
267267+3. Third list item
268268+269269+You can use `shift + enter` to insert a [line break](https://help.obsidian.md/syntax#Line%20breaks) within an ordered list without altering the numbering.
270270+271271+```md
272272+1. First list item
273273+274274+2. Second list item
275275+3. Third list item
276276+277277+4. Fourth list item
278278+5. Fifth list item
279279+6. Sixth list item
280280+```
281281+282282+### Task lists
283283+284284+To create a task list, start each list item with a hyphen and space followed by `[ ]`.
285285+286286+```md
287287+- [x] This is a completed task.
288288+- [ ] This is an incomplete task.
289289+```
290290+291291+- This is a completed task.
292292+- This is an incomplete task.
293293+294294+You can toggle a task in Reading view by selecting the checkbox.
295295+296296+Tip
297297+298298+You can use any character inside the brackets to mark it as complete.
299299+300300+```md
301301+- [x] Milk
302302+- [?] Eggs
303303+- [-] Eggs
304304+```
305305+- Milk
306306+- Eggs
307307+- Eggs
308308+309309+### Nesting lists
310310+311311+You can nest any type of list—ordered, unordered, or task lists—under any other type of list.
312312+313313+To create a nested list, indent one or more list items. You can mix list types within a nested structure:
314314+315315+```md
316316+1. First list item
317317+ 1. Ordered nested list item
318318+2. Second list item
319319+ - Unordered nested list item
320320+```
321321+322322+1. First list item
323323+ 1. Ordered nested list item
324324+2. Second list item
325325+ - Unordered nested list item
326326+327327+Similarly, you can create a nested task list by indenting one or more list items:
328328+329329+```md
330330+- [ ] Task item 1
331331+ - [ ] Subtask 1
332332+- [ ] Task item 2
333333+ - [ ] Subtask 1
334334+```
335335+336336+- Task item 1
337337+ - Subtask 1
338338+- Task item 2
339339+ - Subtask 1
340340+341341+Use `Tab` or `Shift+Tab` to indent or unindent selected list items to easily organize them.
342342+343343+## Horizontal rule
344344+345345+You can use three or more stars `***`, hyphens `---`, or underscore `___` on its own line to add a horizontal bar. You can also separate symbols using spaces.
346346+347347+---
348348+349349+## Code
350350+351351+You can format code both inline within a sentence, or in its own block.
352352+353353+### Inline code
354354+355355+You can format code within a sentence using single backticks.
356356+357357+```md
358358+\`backticks\`
359359+```
360360+361361+Text inside `backticks` on a line will be formatted like code.
362362+363363+If you want to put backticks in an inline code block, surround it with double backticks like so: inline ``code with a backtick ` inside``.
364364+365365+### Code blocks
366366+367367+To format code as a block, enclose it with three backticks or three tildes.
368368+369369+```md
370370+\`\`\`
371371+cd ~/Desktop
372372+\`\`\`
373373+```
374374+375375+```md
376376+~~~
377377+cd ~/Desktop
378378+~~~
379379+```
380380+381381+```md
382382+cd ~/Desktop
383383+```
384384+385385+You can also create a code block by indenting the text using `Tab` or 4 blank spaces.
386386+387387+```md
388388+cd ~/Desktop
389389+```
390390+391391+You can add syntax highlighting to a code block, by adding a language code after the first set of backticks.
392392+393393+```md
394394+\`\`\`js
395395+function fancyAlert(arg) {
396396+ if(arg) {
397397+ $.facebox({div:'#foo'})
398398+ }
399399+}
400400+\`\`\`
401401+```
402402+403403+```js
404404+function fancyAlert(arg) {
405405+ if(arg) {
406406+ $.facebox({div:'#foo'})
407407+ }
408408+}
409409+```
410410+411411+Obsidian uses Prism for syntax highlighting. For more information, refer to [Supported languages](https://prismjs.com/#supported-languages).
412412+413413+Note
414414+415415+[Source mode](https://help.obsidian.md/edit-and-read#Source%20mode) and [Live Preview](https://help.obsidian.md/edit-and-read#Live%20Preview) do not support PrismJS, and may render syntax highlighting differently.
416416+417417+## Footnotes
418418+419419+You can add footnotes[^1] to your notes using the following syntax:
420420+421421+```md
422422+This is a simple footnote[^1].
423423+424424+[^1]: This is the referenced text.
425425+[^2]: Add 2 spaces at the start of each new line.
426426+ This lets you write footnotes that span multiple lines.
427427+[^note]: Named footnotes still appear as numbers, but can make it easier to identify and link references.
428428+```
429429+430430+You can also inline footnotes in a sentence. Note that the caret goes outside the brackets. [^This is an inline footnote.][^2]
431431+432432+```md
433433+You can also use inline footnotes. [^This is an inline footnote.]
434434+```
435435+436436+Note
437437+438438+Inline footnotes only work in reading view, not in Live Preview.
439439+440440+## Comments
441441+442442+```md
443443+This is an %%inline%% comment.
444444+445445+%%
446446+This is a block comment.
447447+448448+Block comments can span multiple lines.
449449+%%
450450+```
451451+452452+## Escaping Markdown Syntax
453453+454454+In some cases, you may need to display special characters in Markdown, such as `*`, `_`, or `#`, without triggering their formatting. To display these characters literally, place a backslash (`\`) before them.
455455+456456+Common characters to escape
457457+458458+- Asterisk: `\*`
459459+- Underscore: `\_`
460460+- Hashtag: `\#`
461461+- Backtick: `` \` ``
462462+- Pipe (used in tables): `\|`
463463+- Tilde: `\~`
464464+465465+```md
466466+\*This text will not be italicized\*.
467467+```
468468+469469+\*This text will not be italicized\*.
470470+471471+When working with numbered lists, you may need to escape the period after the number to prevent automatic list formatting. Place the backslash (`\`) before the period, **not** before the number.
472472+473473+```md
474474+1\. This won't be a list item.
475475+```
476476+477477+1\. This won't be a list item.
478478+479479+## Learn more
480480+481481+To learn more advanced formatting syntax, such as tables, diagrams, and math expressions, refer to [Advanced formatting syntax](https://help.obsidian.md/advanced-syntax).
482482+483483+To learn more about how Obsidian parses Markdown, refer to [Obsidian Flavored Markdown](https://help.obsidian.md/obsidian-flavored-markdown).
484484+485485+---
486486+487487+[^1]: This is a footnote with math and code.
488488+489489+ ```=mathtex
490490+ x+\sqrt{1-x^2}
491491+ ```
492492+493493+ ```md
494494+ [^1]: This is a footnote.
495495+ ```
496496+497497+[^2]: Not supported by supermd