actualNoteContentPart: When working with the [Amplenote Plugin API](https://www.amplenote.com/help/developing_amplenote_plugins) , the medium by which note content is retrieved and inserted is markdown. Some of the API methods that facilitate markdown exchange include:
  [app.getNoteContent](https://www.amplenote.com/help/developing_amplenote_plugins#app.getNoteContent)  
  [app.getNoteSections](https://www.amplenote.com/help/developing_amplenote_plugins#app.getNoteSections)  
  [app.insertTask](https://www.amplenote.com/help/developing_amplenote_plugins#app.insertTask)  
  [app.replaceNoteContent](https://www.amplenote.com/help/developing_amplenote_plugins#app.replaceNoteContent)  
  [app.updateTask](https://www.amplenote.com/help/developing_amplenote_plugins#app.updateTask)  
  [Plus the counterparts in the Note Interface]() . This page will document useful and/or common tactics for maximizing the potential of Amplenote markdown.
  
  # Markdown Basics
  The markdown syntax utilized by Amplenote's plugin system is also used by Amplenote's export and import functionality. Thus, if you need a quick peek at how some concept is expressed in Amplenote markdown, put the formatted content in a note, and choose "Download" to see how to write it in markdown:
  
  
  
  
  
  Choosing "Download Note" will initiate a browser download of a markdown file
  
  The note you download can be dragged into Peek Viewer, to either open the file in Peek Viewer, or open it in your browser, [depending on which browser is being used]() . Either way, you'll be able to see the markdown content of the note you were working in.
  
  Generally speaking, Amplenote markdown support follows the [GitHub Flavored Markdown Spec](https://github.github.com/gfm/) .
  
  # Colored Text and Colored Backgrounds
  Color in Amplenote is transmitted by way of an HTML comment within a "highlight" (e.g., ==highlighted text==) element. Generally, color should be communicated as an integer value for the cycleColor or backgroundCycleColor key:
  
  ```
  function example(noteInterface) {  await noteInterface.insertContent(`==Red text<!-- {"cycleColor": "23"} -->==`);  await noteInterface.insertContent(`on ==green background<!-- {"backgroundCycleColor": "37","cycleColor":"0" } -->==`, { atEnd: true });  await noteInterface.insertContent(`**==followed by bold blue on golden background<!-- {"backgroundCycleColor":"25","cycleColor":"29"} -->==**`, { atEnd: true });}
  ```
  
  Results in the following output:
  
  Red text
  on green background
  **followed by bold blue on golden background**
  
  Note that highlight formatting will not be applied if there are any spaces between the end of the == block that begins the highlight, and the text itself. That is, ==Works<!-- {"cycleColor":"1"} -->== vs == Doesn't work 😞 <!-- {"cycleColor":"1"} -->==.
  
  ## Index of Cycle Colors
  The benefit of using cycle colors is that the colors will automatically transition to appropriate colors in light or dark mode. Below are the indexes of Amplenote's 60 supported colors.
  
  ### Light Mode
  
  
  
  
  
  ### Dark Mode
  
  
  
  
  
  # Inserting a Rich Footnote
  When Rich Footnotes include images or descriptions, those appended to the note content as actual footnotes:
  
  ```
  [Rich Footnote on a new line after bold bullet title][^1] [^1]: [Rich Footnote description text]()  ![](https://images.amplenote.com/c6cf84d6-ceb4-11ed-a7db-d2ab91c23399/53eb85c9-e7d3-4a7f-92e3-b68fa595113c.png)
  ```
processedNoteContent: ---
  title: Markdown Reference for Plugin API
  tags: 
  ---
  When working with the [Amplenote Plugin API](https://www.amplenote.com)`
   , the medium by which note content is retrieved and inserted is markdown. Some of the API methods that facilitate markdown exchange include:
  [app.getNoteContent](https://www.amplenote.com)`
  
  [app.getNoteSections](https://www.amplenote.com)`
  
  [app.insertTask](https://www.amplenote.com)`
  
  [app.replaceNoteContent](https://www.amplenote.com)`
  
  [app.updateTask](https://www.amplenote.com)`
  
  [Plus the counterparts in the Note Interface]()
   . This page will document useful and/or common tactics for maximizing the potential of Amplenote markdown. 
  Markdown Basics
  The markdown syntax utilized by Amplenote's plugin system is also used by Amplenote's export and import functionality. Thus, if you need a quick peek at how some concept is expressed in Amplenote markdown, put the formatted content in a note, and choose "Download" to see how to write it in markdown: Choosing "Download Note" will initiate a browser download of a markdown file The note you download can be dragged into Peek Viewer, to either open the file in Peek Viewer, or open it in your browser, [depending on which browser is being used]()
   . Either way, you'll be able to see the markdown content of the note you were working in. Generally speaking, Amplenote markdown support follows the [GitHub Flavored Markdown Spec](https://github.github.com)`
   . 
  Colored Text and Colored Backgrounds
  Color in Amplenote is transmitted by way of an HTML comment within a "highlight" (e.g., ==highlighted text==) element. Generally, color should be communicated as an integer value for the cycleColor or backgroundCycleColor key: function example(noteInterface) {  await noteInterface.insertContent(`==Red text<!-- {"cycleColor": "23"} -->==`);  await noteInterface.insertContent(`on ==green background<!-- {"backgroundCycleColor": "37","cycleColor":"0" } -->==`, { atEnd: true });  await noteInterface.insertContent(`**==followed by bold blue on golden background<!-- {"backgroundCycleColor":"25","cycleColor":"29"} -->==**`, { atEnd: true });}
  Results in the following output: Red text
  on green background
  followed by bold blue on golden background
  Note that highlight formatting will not be applied if there are any spaces between the end of the == block that begins the highlight, and the text itself. That is, ==Works 
  == vs == Doesn't work 😞 
  ==. 
  Index of Cycle Colors
  The benefit of using cycle colors is that the colors will automatically transition to appropriate colors in light or dark mode. Below are the indexes of Amplenote's 60 supported colors. 
  Light Mode
  
  Dark Mode
  
  Inserting a Rich Footnote
  When Rich Footnotes include images or descriptions, those appended to the note content as actual footnotes: [Rich Footnote on a new line after bold bullet title][^1] [^1]: [Rich Footnote description text]()  ![](https://images.amplenote.com/c6cf84d6-ceb4-11ed-a7db-d2ab91c23399/53eb85c9-e7d3-4a7f-92e3-b68fa595113c.png)
noteTitle: Markdown Reference for Plugin API