| 1 | --- |
| 2 | name: frontmatter-merging |
| 3 | description: Priority rules when importing slides with conflicting frontmatter |
| 4 | --- |
| 5 | |
| 6 | # Frontmatter Merging |
| 7 | |
| 8 | When importing slides, frontmatter from main entry takes priority. |
| 9 | |
| 10 | ## Example |
| 11 | |
| 12 | Main file (`slides.md`): |
| 13 | ```md |
| 14 | --- |
| 15 | src: ./cover.md |
| 16 | background: https://sli.dev/bar.png |
| 17 | class: text-center |
| 18 | --- |
| 19 | ``` |
| 20 | |
| 21 | Imported file (`cover.md`): |
| 22 | ```md |
| 23 | --- |
| 24 | layout: cover |
| 25 | background: https://sli.dev/foo.png |
| 26 | --- |
| 27 | |
| 28 | # Cover |
| 29 | |
| 30 | Cover Page |
| 31 | ``` |
| 32 | |
| 33 | ## Result |
| 34 | |
| 35 | ```md |
| 36 | --- |
| 37 | layout: cover |
| 38 | background: https://sli.dev/bar.png # main entry wins |
| 39 | class: text-center |
| 40 | --- |
| 41 | |
| 42 | # Cover |
| 43 | |
| 44 | Cover Page |
| 45 | ``` |
| 46 | |
| 47 | ## Priority Rule |
| 48 | |
| 49 | Main entry > Imported file for duplicate keys. |
| 50 |