rework in part of text message entities

src/commonMain/kotlin/com/github/insanusmokrassar/TelegramBotAPI/CommonAbstracts/Captioned.kt

@@ -1,7 +1,7 @@
 package com.github.insanusmokrassar.TelegramBotAPI.CommonAbstracts
 
-import com.github.insanusmokrassar.TelegramBotAPI.types.MessageEntity.MessageEntity
 import com.github.insanusmokrassar.TelegramBotAPI.types.ParseMode.ParseMode
+import com.github.insanusmokrassar.TelegramBotAPI.utils.fullListOfSubSource
 
 interface Captioned {
     val caption: String?
@@ -12,5 +12,7 @@ interface CaptionedOutput : Captioned {
 }
 
 interface CaptionedInput : Captioned {
-    val captionEntities: List<MessageEntity>
+    val captionEntities: List<TextPart>
 }
+
+fun CaptionedInput.fullEntitiesList() = caption ?.fullListOfSubSource(captionEntities) ?.map { it.source } ?: emptyList()

src/commonMain/kotlin/com/github/insanusmokrassar/TelegramBotAPI/CommonAbstracts/TextSource.kt

@@ -1,7 +1,17 @@
 package com.github.insanusmokrassar.TelegramBotAPI.CommonAbstracts
 
 interface TextSource {
-    val rawSource: String
     val asMarkdownSource: String
+    val asMarkdownV2Source: String
     val asHtmlSource: String
 }
+
+
+interface MultilevelTextSource : TextSource {
+    val textParts: List<TextPart>
+}
+
+data class TextPart(
+    val range: IntRange,
+    val source: TextSource
+)

src/commonMain/kotlin/com/github/insanusmokrassar/TelegramBotAPI/types/MessageEntity/BoldTextMessageEntity.kt

@@ -1,12 +0,0 @@
-package com.github.insanusmokrassar.TelegramBotAPI.types.MessageEntity
-
-import com.github.insanusmokrassar.TelegramBotAPI.CommonAbstracts.TextSource
-import com.github.insanusmokrassar.TelegramBotAPI.types.MessageEntity.textsources.BoldTextSource
-import com.github.insanusmokrassar.TelegramBotAPI.utils.boldHTML
-import com.github.insanusmokrassar.TelegramBotAPI.utils.boldMarkdown
-
-data class BoldTextMessageEntity(
-    override val offset: Int,
-    override val length: Int,
-    override val rawSource: String
-) : MessageEntity, TextSource by BoldTextSource(rawSource)

src/commonMain/kotlin/com/github/insanusmokrassar/TelegramBotAPI/types/MessageEntity/BotCommandMessageEntity.kt

@@ -1,16 +0,0 @@
-package com.github.insanusmokrassar.TelegramBotAPI.types.MessageEntity
-
-import com.github.insanusmokrassar.TelegramBotAPI.CommonAbstracts.TextSource
-import com.github.insanusmokrassar.TelegramBotAPI.types.MessageEntity.textsources.BotCommandTextSource
-import com.github.insanusmokrassar.TelegramBotAPI.utils.commandHTML
-import com.github.insanusmokrassar.TelegramBotAPI.utils.commandMarkdown
-
-data class BotCommandMessageEntity(
-    override val offset: Int,
-    override val length: Int,
-    override val rawSource: String,
-    private val botCommandTextSource: BotCommandTextSource = BotCommandTextSource(rawSource)
-) : MessageEntity, TextSource by botCommandTextSource {
-    val command: String
-        get() = botCommandTextSource.command
-}

src/commonMain/kotlin/com/github/insanusmokrassar/TelegramBotAPI/types/MessageEntity/CodeTextMessageEntity.kt

@@ -1,12 +0,0 @@
-package com.github.insanusmokrassar.TelegramBotAPI.types.MessageEntity
-
-import com.github.insanusmokrassar.TelegramBotAPI.CommonAbstracts.TextSource
-import com.github.insanusmokrassar.TelegramBotAPI.types.MessageEntity.textsources.CodeTextSource
-import com.github.insanusmokrassar.TelegramBotAPI.utils.codeHTML
-import com.github.insanusmokrassar.TelegramBotAPI.utils.codeMarkdown
-
-data class CodeTextMessageEntity(
-    override val offset: Int,
-    override val length: Int,
-    override val rawSource: String
-) : MessageEntity, TextSource by CodeTextSource(rawSource)

src/commonMain/kotlin/com/github/insanusmokrassar/TelegramBotAPI/types/MessageEntity/EMailMessageEntity.kt

@@ -1,12 +0,0 @@
-package com.github.insanusmokrassar.TelegramBotAPI.types.MessageEntity
-
-import com.github.insanusmokrassar.TelegramBotAPI.CommonAbstracts.TextSource
-import com.github.insanusmokrassar.TelegramBotAPI.types.MessageEntity.textsources.EMailTextSource
-import com.github.insanusmokrassar.TelegramBotAPI.utils.emailHTML
-import com.github.insanusmokrassar.TelegramBotAPI.utils.emailMarkdown
-
-data class EMailMessageEntity(
-    override val offset: Int,
-    override val length: Int,
-    override val rawSource: String
-) : MessageEntity, TextSource by EMailTextSource(rawSource)

src/commonMain/kotlin/com/github/insanusmokrassar/TelegramBotAPI/types/MessageEntity/HashTagMessageEntity.kt

@@ -1,12 +0,0 @@
-package com.github.insanusmokrassar.TelegramBotAPI.types.MessageEntity
-
-import com.github.insanusmokrassar.TelegramBotAPI.CommonAbstracts.TextSource
-import com.github.insanusmokrassar.TelegramBotAPI.types.MessageEntity.textsources.HashTagTextSource
-import com.github.insanusmokrassar.TelegramBotAPI.utils.hashTagHTML
-import com.github.insanusmokrassar.TelegramBotAPI.utils.hashTagMarkdown
-
-data class HashTagMessageEntity(
-    override val offset: Int,
-    override val length: Int,
-    override val rawSource: String
-) : MessageEntity, TextSource by HashTagTextSource(rawSource)

src/commonMain/kotlin/com/github/insanusmokrassar/TelegramBotAPI/types/MessageEntity/ItalicTextMessageEntity.kt

@@ -1,12 +0,0 @@
-package com.github.insanusmokrassar.TelegramBotAPI.types.MessageEntity
-
-import com.github.insanusmokrassar.TelegramBotAPI.CommonAbstracts.TextSource
-import com.github.insanusmokrassar.TelegramBotAPI.types.MessageEntity.textsources.ItalicTextSource
-import com.github.insanusmokrassar.TelegramBotAPI.utils.italicHTML
-import com.github.insanusmokrassar.TelegramBotAPI.utils.italicMarkdown
-
-data class ItalicTextMessageEntity(
-    override val offset: Int,
-    override val length: Int,
-    override val rawSource: String
-) : MessageEntity, TextSource by ItalicTextSource(rawSource)

src/commonMain/kotlin/com/github/insanusmokrassar/TelegramBotAPI/types/MessageEntity/MentionMessageEntity.kt

@@ -1,12 +0,0 @@
-package com.github.insanusmokrassar.TelegramBotAPI.types.MessageEntity
-
-import com.github.insanusmokrassar.TelegramBotAPI.CommonAbstracts.TextSource
-import com.github.insanusmokrassar.TelegramBotAPI.types.MessageEntity.textsources.MentionTextSource
-import com.github.insanusmokrassar.TelegramBotAPI.utils.mentionHTML
-import com.github.insanusmokrassar.TelegramBotAPI.utils.mentionMarkdown
-
-class MentionMessageEntity(
-    override val offset: Int,
-    override val length: Int,
-    override val rawSource: String
-) : MessageEntity, TextSource by MentionTextSource(rawSource)

src/commonMain/kotlin/com/github/insanusmokrassar/TelegramBotAPI/types/MessageEntity/MessageEntity.kt

@@ -1,11 +0,0 @@
-package com.github.insanusmokrassar.TelegramBotAPI.types.MessageEntity
-
-import com.github.insanusmokrassar.TelegramBotAPI.CommonAbstracts.TextSource
-
-interface MessageEntity : TextSource {
-    val offset: Int
-    val length: Int
-    @Deprecated("Due to opportunity to get the same string from rawSource const", ReplaceWith("rawSource"))
-    val sourceString: String
-        get() = rawSource
-}

src/commonMain/kotlin/com/github/insanusmokrassar/TelegramBotAPI/types/MessageEntity/PhoneNumberMessageEntity.kt

@@ -1,12 +0,0 @@
-package com.github.insanusmokrassar.TelegramBotAPI.types.MessageEntity
-
-import com.github.insanusmokrassar.TelegramBotAPI.CommonAbstracts.TextSource
-import com.github.insanusmokrassar.TelegramBotAPI.types.MessageEntity.textsources.PhoneNumberTextSource
-import com.github.insanusmokrassar.TelegramBotAPI.utils.phoneHTML
-import com.github.insanusmokrassar.TelegramBotAPI.utils.phoneMarkdown
-
-data class PhoneNumberMessageEntity(
-    override val offset: Int,
-    override val length: Int,
-    override val rawSource: String
-) : MessageEntity, TextSource by PhoneNumberTextSource(rawSource)

src/commonMain/kotlin/com/github/insanusmokrassar/TelegramBotAPI/types/MessageEntity/PreTextMessageEntity.kt

@@ -1,12 +0,0 @@
-package com.github.insanusmokrassar.TelegramBotAPI.types.MessageEntity
-
-import com.github.insanusmokrassar.TelegramBotAPI.CommonAbstracts.TextSource
-import com.github.insanusmokrassar.TelegramBotAPI.types.MessageEntity.textsources.PreTextSource
-import com.github.insanusmokrassar.TelegramBotAPI.utils.preHTML
-import com.github.insanusmokrassar.TelegramBotAPI.utils.preMarkdown
-
-data class PreTextMessageEntity(
-    override val offset: Int,
-    override val length: Int,
-    override val rawSource: String
-) : MessageEntity, TextSource by PreTextSource(rawSource)

src/commonMain/kotlin/com/github/insanusmokrassar/TelegramBotAPI/types/MessageEntity/RawMessageEntity.kt

@@ -1,10 +1,11 @@
 package com.github.insanusmokrassar.TelegramBotAPI.types.MessageEntity
 
+import com.github.insanusmokrassar.TelegramBotAPI.CommonAbstracts.MultilevelTextSource
+import com.github.insanusmokrassar.TelegramBotAPI.CommonAbstracts.TextPart
+import com.github.insanusmokrassar.TelegramBotAPI.types.MessageEntity.textsources.*
 import com.github.insanusmokrassar.TelegramBotAPI.types.User
-import com.github.insanusmokrassar.TelegramBotAPI.types.chat.abstracts.PrivateChat
+import com.github.insanusmokrassar.TelegramBotAPI.utils.shiftSourcesToTheLeft
-import kotlinx.serialization.KSerializer
 import kotlinx.serialization.Serializable
-import kotlinx.serialization.internal.ArrayListSerializer
 
 @Serializable
 internal data class RawMessageEntity(
@@ -13,32 +14,74 @@ internal data class RawMessageEntity(
     val length: Int,
     val url: String? = null,
     val user: User? = null
-) {
+)
-    fun asMessageEntity(source: String): MessageEntity {
+
+internal fun RawMessageEntity.asTextParts(source: String, subParts: List<TextPart>): List<TextPart> {
     val sourceSubstring = source.substring(offset, offset + length)
+    val range = offset until (offset + length)
+    val shiftedSubParts = subParts.shiftSourcesToTheLeft(offset)
     return when (type) {
-            "mention" -> MentionMessageEntity(offset, length, sourceSubstring)
+        "mention" -> MentionTextSource(sourceSubstring, shiftedSubParts)
-            "hashtag" -> HashTagMessageEntity(offset, length, sourceSubstring)
+        "hashtag" -> HashTagTextSource(sourceSubstring, shiftedSubParts)
         "cashtag" -> TODO()
-            "bot_command" -> BotCommandMessageEntity(offset, length, sourceSubstring)
+        "bot_command" -> BotCommandTextSource(sourceSubstring, shiftedSubParts)
-            "url" -> URLMessageEntity(offset, length, sourceSubstring)
+        "url" -> URLTextSource(sourceSubstring)
-            "email" -> EMailMessageEntity(offset, length, sourceSubstring)
+        "email" -> EMailTextSource(sourceSubstring, shiftedSubParts)
-            "phone_number" -> PhoneNumberMessageEntity(offset, length, sourceSubstring)
+        "phone_number" -> PhoneNumberTextSource(sourceSubstring, shiftedSubParts)
-            "bold" -> BoldTextMessageEntity(offset, length, sourceSubstring)
+        "bold" -> BoldTextSource(sourceSubstring, shiftedSubParts)
-            "italic" -> ItalicTextMessageEntity(offset, length, sourceSubstring)
+        "italic" -> ItalicTextSource(sourceSubstring, shiftedSubParts)
-            "code" -> CodeTextMessageEntity(offset, length, sourceSubstring)
+        "code" -> CodeTextSource(sourceSubstring)
-            "pre" -> PreTextMessageEntity(offset, length, sourceSubstring)
+        "pre" -> PreTextSource(sourceSubstring)
-            "text_link" -> TextLinkMessageEntity(offset, length, sourceSubstring, url ?: throw IllegalStateException("URL must not be null for text link"))
+        "text_link" -> TextLinkTextSource(sourceSubstring, url ?: throw IllegalStateException("URL must not be null for text link"))
-            "text_mention" -> TextMentionMessageEntity(offset, length, sourceSubstring, user ?: throw IllegalStateException("User must not be null for text mention"))
+        "text_mention" -> TextMentionTextSource(sourceSubstring, user ?: throw IllegalStateException("User must not be null for text mention"), shiftedSubParts)
-            "underline" -> UnderlineMessageEntity(offset, length, sourceSubstring)
+        "underline" -> UnderlineTextSource(sourceSubstring, shiftedSubParts)
-            "strikethrough" -> StrikethroughMessageEntity(offset, length, sourceSubstring)
+        "strikethrough" -> StrikethroughTextSource(sourceSubstring, shiftedSubParts)
-            else -> RegularTextMessageEntity(offset, length, sourceSubstring)
+        else -> RegularTextSource(sourceSubstring)
+    }.let {
+        val part = TextPart(range, it)
+        if (it !is MultilevelTextSource) {
+            (subParts + part).sortedBy { currentPart -> currentPart.range.first }
+        } else {
+            listOf(part)
         }
     }
 }
 
+internal fun createTextPart(from: String, entities: RawMessageEntities): List<TextPart> {
+    val mutableEntities = entities.toMutableList()
+    mutableEntities.sortBy { it.offset }
+    val resultList = mutableListOf<TextPart>()
+
+    while (mutableEntities.isNotEmpty()) {
+        val currentFirst = mutableEntities.removeAt(0)
+        val subEntities = if (mutableEntities.isNotEmpty()) {
+            val lastIndex = currentFirst.offset + currentFirst.length
+            val subEntities = mutableListOf<RawMessageEntity>()
+            while (mutableEntities.isNotEmpty()) {
+                val currentPossibleSubEntity = mutableEntities.first()
+                if (currentPossibleSubEntity.offset < lastIndex) {
+                    subEntities.add(currentPossibleSubEntity)
+                    mutableEntities.removeAt(0)
+                } else {
+                    break
+                }
+            }
+            subEntities
+        } else {
+            emptyList<RawMessageEntity>()
+        }
+
+        resultList.addAll(
+            currentFirst.asTextParts(
+                from,
+                createTextPart(from, subEntities)
+            )
+        )
+    }
+
+    return resultList
+}
+
+internal fun RawMessageEntities.asTextParts(sourceString: String): List<TextPart> = createTextPart(sourceString, this)
+
 internal typealias RawMessageEntities = List<RawMessageEntity>
-
-internal object RawMessageEntitiesSerializer : KSerializer<List<RawMessageEntity>> by ArrayListSerializer(
-    RawMessageEntity.serializer()
-)

src/commonMain/kotlin/com/github/insanusmokrassar/TelegramBotAPI/types/MessageEntity/RegularTextMessageEntity.kt

@@ -1,12 +0,0 @@
-package com.github.insanusmokrassar.TelegramBotAPI.types.MessageEntity
-
-import com.github.insanusmokrassar.TelegramBotAPI.CommonAbstracts.TextSource
-import com.github.insanusmokrassar.TelegramBotAPI.types.MessageEntity.textsources.RegularTextSource
-import com.github.insanusmokrassar.TelegramBotAPI.utils.extensions.toHtml
-import com.github.insanusmokrassar.TelegramBotAPI.utils.extensions.toMarkdown
-
-data class RegularTextMessageEntity(
-    override val offset: Int,
-    override val length: Int,
-    override val rawSource: String
-) : MessageEntity, TextSource by RegularTextSource(rawSource)

src/commonMain/kotlin/com/github/insanusmokrassar/TelegramBotAPI/types/MessageEntity/StrikethroughMessageEntity.kt

@@ -1,10 +0,0 @@
-package com.github.insanusmokrassar.TelegramBotAPI.types.MessageEntity
-
-import com.github.insanusmokrassar.TelegramBotAPI.CommonAbstracts.TextSource
-import com.github.insanusmokrassar.TelegramBotAPI.types.MessageEntity.textsources.StrikethroughTextSource
-
-class StrikethroughMessageEntity(
-    override val offset: Int,
-    override val length: Int,
-    override val rawSource: String
-) : MessageEntity, TextSource by StrikethroughTextSource(rawSource)

src/commonMain/kotlin/com/github/insanusmokrassar/TelegramBotAPI/types/MessageEntity/TextLinkMessageEntity.kt

@@ -1,13 +0,0 @@
-package com.github.insanusmokrassar.TelegramBotAPI.types.MessageEntity
-
-import com.github.insanusmokrassar.TelegramBotAPI.CommonAbstracts.TextSource
-import com.github.insanusmokrassar.TelegramBotAPI.types.MessageEntity.textsources.TextLinkTextSource
-import com.github.insanusmokrassar.TelegramBotAPI.utils.linkHTML
-import com.github.insanusmokrassar.TelegramBotAPI.utils.linkMarkdown
-
-data class TextLinkMessageEntity(
-    override val offset: Int,
-    override val length: Int,
-    override val rawSource: String,
-    val url: String
-) : MessageEntity, TextSource by TextLinkTextSource(rawSource, url)

src/commonMain/kotlin/com/github/insanusmokrassar/TelegramBotAPI/types/MessageEntity/TextMentionMessageEntity.kt

@@ -1,15 +0,0 @@
-package com.github.insanusmokrassar.TelegramBotAPI.types.MessageEntity
-
-import com.github.insanusmokrassar.TelegramBotAPI.CommonAbstracts.TextSource
-import com.github.insanusmokrassar.TelegramBotAPI.types.MessageEntity.textsources.TextMentionTextSource
-import com.github.insanusmokrassar.TelegramBotAPI.types.User
-import com.github.insanusmokrassar.TelegramBotAPI.types.chat.abstracts.PrivateChat
-import com.github.insanusmokrassar.TelegramBotAPI.utils.mentionHTML
-import com.github.insanusmokrassar.TelegramBotAPI.utils.mentionMarkdown
-
-class TextMentionMessageEntity(
-    override val offset: Int,
-    override val length: Int,
-    override val rawSource: String,
-    val privateChat: PrivateChat
-) : MessageEntity, TextSource by TextMentionTextSource(rawSource, privateChat)

src/commonMain/kotlin/com/github/insanusmokrassar/TelegramBotAPI/types/MessageEntity/URLMessageEntity.kt

@@ -1,15 +0,0 @@
-package com.github.insanusmokrassar.TelegramBotAPI.types.MessageEntity
-
-import com.github.insanusmokrassar.TelegramBotAPI.CommonAbstracts.TextSource
-import com.github.insanusmokrassar.TelegramBotAPI.types.MessageEntity.textsources.URLTextSource
-import com.github.insanusmokrassar.TelegramBotAPI.utils.linkHTML
-import com.github.insanusmokrassar.TelegramBotAPI.utils.linkMarkdown
-
-data class URLMessageEntity(
-    override val offset: Int,
-    override val length: Int,
-    override val rawSource: String
-) : MessageEntity, TextSource by URLTextSource(rawSource) {
-    val url: String
-        get() = rawSource
-}

src/commonMain/kotlin/com/github/insanusmokrassar/TelegramBotAPI/types/MessageEntity/UnderlineMessageEntity.kt

@@ -1,10 +0,0 @@
-package com.github.insanusmokrassar.TelegramBotAPI.types.MessageEntity
-
-import com.github.insanusmokrassar.TelegramBotAPI.CommonAbstracts.TextSource
-import com.github.insanusmokrassar.TelegramBotAPI.types.MessageEntity.textsources.UnderlineTextSource
-
-class UnderlineMessageEntity(
-    override val offset: Int,
-    override val length: Int,
-    override val rawSource: String
-) : MessageEntity, TextSource by UnderlineTextSource(rawSource)

src/commonMain/kotlin/com/github/insanusmokrassar/TelegramBotAPI/types/MessageEntity/textsources/BoldTextSource.kt

@@ -1,14 +1,15 @@
 package com.github.insanusmokrassar.TelegramBotAPI.types.MessageEntity.textsources
 
-import com.github.insanusmokrassar.TelegramBotAPI.CommonAbstracts.TextSource
+import com.github.insanusmokrassar.TelegramBotAPI.CommonAbstracts.MultilevelTextSource
-import com.github.insanusmokrassar.TelegramBotAPI.utils.boldHTML
+import com.github.insanusmokrassar.TelegramBotAPI.CommonAbstracts.TextPart
-import com.github.insanusmokrassar.TelegramBotAPI.utils.boldMarkdown
+import com.github.insanusmokrassar.TelegramBotAPI.utils.*
 
 class BoldTextSource(
-    override val rawSource: String
+    source: String,
-) : TextSource {
+    textParts: List<TextPart>
-    override val asMarkdownSource: String
+) : MultilevelTextSource {
-        get() = rawSource.boldMarkdown()
+    override val textParts: List<TextPart> = source.fullListOfSubSource(textParts)
-    override val asHtmlSource: String
+    override val asMarkdownSource: String by lazy { source.boldMarkdown() }
-        get() = rawSource.boldHTML()
+    override val asMarkdownV2Source: String by lazy { boldMarkdownV2() }
+    override val asHtmlSource: String by lazy { boldHTML() }
 }

src/commonMain/kotlin/com/github/insanusmokrassar/TelegramBotAPI/types/MessageEntity/textsources/BotCommandTextSource.kt

@@ -1,20 +1,25 @@
 package com.github.insanusmokrassar.TelegramBotAPI.types.MessageEntity.textsources
 
-import com.github.insanusmokrassar.TelegramBotAPI.CommonAbstracts.TextSource
+import com.github.insanusmokrassar.TelegramBotAPI.CommonAbstracts.MultilevelTextSource
-import com.github.insanusmokrassar.TelegramBotAPI.utils.commandHTML
+import com.github.insanusmokrassar.TelegramBotAPI.CommonAbstracts.TextPart
-import com.github.insanusmokrassar.TelegramBotAPI.utils.commandMarkdown
+import com.github.insanusmokrassar.TelegramBotAPI.utils.*
 
 private val commandRegex = Regex("[/!][^@\\s]*")
 
 class BotCommandTextSource(
-    override val rawSource: String
+    source: String,
-) : TextSource {
+    textParts: List<TextPart>
-    override val asMarkdownSource: String
+) : MultilevelTextSource {
-        get() = rawSource.commandMarkdown()
-    override val asHtmlSource: String
-        get() = rawSource.commandHTML()
-
     val command: String by lazy {
-        commandRegex.find(rawSource) ?.value ?.substring(1) ?: rawSource.substring(1)// skip first symbol like "/" or "!"
+        commandRegex.find(source) ?.value ?.substring(1) ?: source.substring(1)// skip first symbol like "/" or "!"
     }
+
+    override val textParts: List<TextPart> by lazy {
+        command.fullListOfSubSource(
+            textParts.shiftSourcesToTheLeft(1)
+        )
+    }
+    override val asMarkdownSource: String by lazy { source.commandMarkdown() }
+    override val asMarkdownV2Source: String by lazy { commandMarkdownV2() }
+    override val asHtmlSource: String by lazy { commandHTML() }
 }

src/commonMain/kotlin/com/github/insanusmokrassar/TelegramBotAPI/types/MessageEntity/textsources/CodeTextSource.kt

@@ -1,14 +1,13 @@
 package com.github.insanusmokrassar.TelegramBotAPI.types.MessageEntity.textsources
 
 import com.github.insanusmokrassar.TelegramBotAPI.CommonAbstracts.TextSource
-import com.github.insanusmokrassar.TelegramBotAPI.utils.codeHTML
+import com.github.insanusmokrassar.TelegramBotAPI.utils.*
-import com.github.insanusmokrassar.TelegramBotAPI.utils.codeMarkdown
+import com.github.insanusmokrassar.TelegramBotAPI.utils.extensions.escapeMarkdownV2PreAndCode
 
 class CodeTextSource(
-    override val rawSource: String
+    source: String
 ) : TextSource {
-    override val asMarkdownSource: String
+    override val asMarkdownSource: String by lazy { source.codeMarkdown() }
-        get() = rawSource.codeMarkdown()
+    override val asMarkdownV2Source: String by lazy { source.codeMarkdownV2() }
-    override val asHtmlSource: String
+    override val asHtmlSource: String by lazy { source.codeHTML() }
-        get() = rawSource.codeHTML()
 }

src/commonMain/kotlin/com/github/insanusmokrassar/TelegramBotAPI/types/MessageEntity/textsources/EMailTextSource.kt

@@ -1,14 +1,14 @@
 package com.github.insanusmokrassar.TelegramBotAPI.types.MessageEntity.textsources
 
-import com.github.insanusmokrassar.TelegramBotAPI.CommonAbstracts.TextSource
+import com.github.insanusmokrassar.TelegramBotAPI.CommonAbstracts.*
-import com.github.insanusmokrassar.TelegramBotAPI.utils.emailHTML
+import com.github.insanusmokrassar.TelegramBotAPI.utils.*
-import com.github.insanusmokrassar.TelegramBotAPI.utils.emailMarkdown
 
 class EMailTextSource(
-    override val rawSource: String
+    source: String,
-) : TextSource {
+    textParts: List<TextPart>
-    override val asMarkdownSource: String
+) : MultilevelTextSource {
-        get() = rawSource.emailMarkdown()
+    override val textParts: List<TextPart> by lazy { source.fullListOfSubSource(textParts) }
-    override val asHtmlSource: String
+    override val asMarkdownSource: String by lazy { source.emailMarkdown() }
-        get() = rawSource.emailHTML()
+    override val asMarkdownV2Source: String by lazy { emailMarkdownV2(source) }
+    override val asHtmlSource: String by lazy { emailHTML(source) }
 }

src/commonMain/kotlin/com/github/insanusmokrassar/TelegramBotAPI/types/MessageEntity/textsources/HashTagTextSource.kt

@@ -1,14 +1,23 @@
 package com.github.insanusmokrassar.TelegramBotAPI.types.MessageEntity.textsources
 
-import com.github.insanusmokrassar.TelegramBotAPI.CommonAbstracts.TextSource
+import com.github.insanusmokrassar.TelegramBotAPI.CommonAbstracts.*
-import com.github.insanusmokrassar.TelegramBotAPI.utils.hashTagHTML
+import com.github.insanusmokrassar.TelegramBotAPI.utils.*
-import com.github.insanusmokrassar.TelegramBotAPI.utils.hashTagMarkdown
+
+private val String.withoutSharp
+    get() = if (startsWith("#")){
+        substring(1)
+    } else {
+        this
+    }
 
 class HashTagTextSource(
-    override val rawSource: String
+    source: String,
-) : TextSource {
+    textParts: List<TextPart>
-    override val asMarkdownSource: String
+) : MultilevelTextSource {
-        get() = rawSource.hashTagMarkdown()
+    override val textParts: List<TextPart> = source.withoutSharp.fullListOfSubSource(
-    override val asHtmlSource: String
+        textParts.shiftSourcesToTheLeft(1)
-        get() = rawSource.hashTagHTML()
+    )
+    override val asMarkdownSource: String by lazy { source.hashTagMarkdown() }
+    override val asMarkdownV2Source: String by lazy { hashTagMarkdownV2() }
+    override val asHtmlSource: String by lazy { hashTagHTML() }
 }

src/commonMain/kotlin/com/github/insanusmokrassar/TelegramBotAPI/types/MessageEntity/textsources/ItalicTextSource.kt

@@ -1,14 +1,15 @@
 package com.github.insanusmokrassar.TelegramBotAPI.types.MessageEntity.textsources
 
-import com.github.insanusmokrassar.TelegramBotAPI.CommonAbstracts.TextSource
+import com.github.insanusmokrassar.TelegramBotAPI.CommonAbstracts.MultilevelTextSource
-import com.github.insanusmokrassar.TelegramBotAPI.utils.italicHTML
+import com.github.insanusmokrassar.TelegramBotAPI.CommonAbstracts.TextPart
-import com.github.insanusmokrassar.TelegramBotAPI.utils.italicMarkdown
+import com.github.insanusmokrassar.TelegramBotAPI.utils.*
 
 class ItalicTextSource(
-    override val rawSource: String
+    source: String,
-) : TextSource {
+    textParts: List<TextPart>
-    override val asMarkdownSource: String
+) : MultilevelTextSource {
-        get() = rawSource.italicMarkdown()
+    override val textParts: List<TextPart> = source.fullListOfSubSource(textParts)
-    override val asHtmlSource: String
+    override val asMarkdownSource: String by lazy { source.italicMarkdown() }
-        get() = rawSource.italicHTML()
+    override val asMarkdownV2Source: String by lazy { italicMarkdownV2() }
+    override val asHtmlSource: String by lazy { italicHTML() }
 }

src/commonMain/kotlin/com/github/insanusmokrassar/TelegramBotAPI/types/MessageEntity/textsources/MentionTextSource.kt

@@ -1,14 +1,25 @@
 package com.github.insanusmokrassar.TelegramBotAPI.types.MessageEntity.textsources
 
-import com.github.insanusmokrassar.TelegramBotAPI.CommonAbstracts.TextSource
+import com.github.insanusmokrassar.TelegramBotAPI.CommonAbstracts.*
-import com.github.insanusmokrassar.TelegramBotAPI.utils.mentionHTML
+import com.github.insanusmokrassar.TelegramBotAPI.utils.*
-import com.github.insanusmokrassar.TelegramBotAPI.utils.mentionMarkdown
+
+private val String.withoutCommercialAt
+    get() = if (startsWith("@")) {
+        substring(1)
+    } else {
+        this
+    }
 
 class MentionTextSource(
-    override val rawSource: String
+    source: String,
-) : TextSource {
+    textParts: List<TextPart>
-    override val asMarkdownSource: String
+) : MultilevelTextSource {
-        get() = rawSource.mentionMarkdown()
+    override val textParts: List<TextPart> by lazy {
-    override val asHtmlSource: String
+        source.withoutCommercialAt.fullListOfSubSource(
-        get() = rawSource.mentionHTML()
+            textParts.shiftSourcesToTheLeft(1)
+        )
+    }
+    override val asMarkdownSource: String by lazy { source.mentionMarkdown() }
+    override val asMarkdownV2Source: String by lazy { mentionMarkdownV2() }
+    override val asHtmlSource: String by lazy { mentionHTML() }
 }

src/commonMain/kotlin/com/github/insanusmokrassar/TelegramBotAPI/types/MessageEntity/textsources/PhoneNumberTextSource.kt

@@ -1,14 +1,14 @@
 package com.github.insanusmokrassar.TelegramBotAPI.types.MessageEntity.textsources
 
-import com.github.insanusmokrassar.TelegramBotAPI.CommonAbstracts.TextSource
+import com.github.insanusmokrassar.TelegramBotAPI.CommonAbstracts.*
-import com.github.insanusmokrassar.TelegramBotAPI.utils.phoneHTML
+import com.github.insanusmokrassar.TelegramBotAPI.utils.*
-import com.github.insanusmokrassar.TelegramBotAPI.utils.phoneMarkdown
 
 class PhoneNumberTextSource(
-    override val rawSource: String
+    source: String,
-) : TextSource {
+    textParts: List<TextPart>
-    override val asMarkdownSource: String
+) : MultilevelTextSource {
-        get() = rawSource.phoneMarkdown()
+    override val textParts: List<TextPart> = source.fullListOfSubSource(textParts)
-    override val asHtmlSource: String
+    override val asMarkdownSource: String by lazy { source.phoneMarkdown() }
-        get() = rawSource.phoneHTML()
+    override val asMarkdownV2Source: String by lazy { phoneMarkdownV2() }
+    override val asHtmlSource: String by lazy { phoneHTML() }
 }

src/commonMain/kotlin/com/github/insanusmokrassar/TelegramBotAPI/types/MessageEntity/textsources/PreTextSource.kt

@@ -1,14 +1,13 @@
 package com.github.insanusmokrassar.TelegramBotAPI.types.MessageEntity.textsources
 
 import com.github.insanusmokrassar.TelegramBotAPI.CommonAbstracts.TextSource
-import com.github.insanusmokrassar.TelegramBotAPI.utils.preHTML
+import com.github.insanusmokrassar.TelegramBotAPI.utils.*
-import com.github.insanusmokrassar.TelegramBotAPI.utils.preMarkdown
 
 class PreTextSource(
-    override val rawSource: String
+    source: String,
+    val language: String? = null
 ) : TextSource {
-    override val asMarkdownSource: String
+    override val asMarkdownSource: String by lazy { source.preMarkdown(language) }
-        get() = rawSource.preMarkdown()
+    override val asMarkdownV2Source: String by lazy { source.preMarkdownV2(language) }
-    override val asHtmlSource: String
+    override val asHtmlSource: String by lazy { source.preHTML(language) }
-        get() = rawSource.preHTML()
 }

src/commonMain/kotlin/com/github/insanusmokrassar/TelegramBotAPI/types/MessageEntity/textsources/RegularTextSource.kt

@@ -1,14 +1,12 @@
 package com.github.insanusmokrassar.TelegramBotAPI.types.MessageEntity.textsources
 
 import com.github.insanusmokrassar.TelegramBotAPI.CommonAbstracts.TextSource
-import com.github.insanusmokrassar.TelegramBotAPI.utils.regularHtml
+import com.github.insanusmokrassar.TelegramBotAPI.utils.*
-import com.github.insanusmokrassar.TelegramBotAPI.utils.regularMarkdown
 
 class RegularTextSource(
-    override val rawSource: String
+    source: String
 ) : TextSource {
-    override val asMarkdownSource: String
+    override val asMarkdownSource: String by lazy { source.regularMarkdown() }
-        get() = rawSource.regularMarkdown()
+    override val asMarkdownV2Source: String by lazy { source.regularMarkdownV2() }
-    override val asHtmlSource: String
+    override val asHtmlSource: String by lazy { source.regularHtml() }
-        get() = rawSource.regularHtml()
 }

src/commonMain/kotlin/com/github/insanusmokrassar/TelegramBotAPI/types/MessageEntity/textsources/StrikethroughTextSource.kt

@@ -1,14 +1,15 @@
 package com.github.insanusmokrassar.TelegramBotAPI.types.MessageEntity.textsources
 
-import com.github.insanusmokrassar.TelegramBotAPI.CommonAbstracts.TextSource
+import com.github.insanusmokrassar.TelegramBotAPI.CommonAbstracts.MultilevelTextSource
-import com.github.insanusmokrassar.TelegramBotAPI.utils.strikethroughHTML
+import com.github.insanusmokrassar.TelegramBotAPI.CommonAbstracts.TextPart
-import com.github.insanusmokrassar.TelegramBotAPI.utils.strikethroughMarkdown
+import com.github.insanusmokrassar.TelegramBotAPI.utils.*
 
 class StrikethroughTextSource(
-    override val rawSource: String
+    source: String,
-) : TextSource {
+    textParts: List<TextPart>
-    override val asHtmlSource: String
+) : MultilevelTextSource {
-        get() = rawSource.strikethroughHTML()
+    override val textParts: List<TextPart> = source.fullListOfSubSource(textParts)
-    override val asMarkdownSource: String
+    override val asHtmlSource: String by lazy { strikethroughHTML() }
-        get() = rawSource.strikethroughMarkdown()
+    override val asMarkdownV2Source: String by lazy { strikethroughMarkdownV2() }
+    override val asMarkdownSource: String by lazy { source.strikethroughMarkdown() }
 }

src/commonMain/kotlin/com/github/insanusmokrassar/TelegramBotAPI/types/MessageEntity/textsources/TextLinkTextSource.kt

@@ -1,13 +1,13 @@
 package com.github.insanusmokrassar.TelegramBotAPI.types.MessageEntity.textsources
 
 import com.github.insanusmokrassar.TelegramBotAPI.CommonAbstracts.TextSource
-import com.github.insanusmokrassar.TelegramBotAPI.utils.linkHTML
+import com.github.insanusmokrassar.TelegramBotAPI.utils.*
-import com.github.insanusmokrassar.TelegramBotAPI.utils.linkMarkdown
 
 class TextLinkTextSource(
-    override val rawSource: String,
+    source: String,
     url: String
 ) : TextSource {
-    override val asMarkdownSource: String = rawSource.linkMarkdown(url)
+    override val asMarkdownSource: String by lazy { source.linkMarkdown(url) }
-    override val asHtmlSource: String = rawSource.linkHTML(url)
+    override val asMarkdownV2Source: String by lazy { source.linkMarkdownV2(url) }
+    override val asHtmlSource: String by lazy { source.linkHTML(url) }
 }

src/commonMain/kotlin/com/github/insanusmokrassar/TelegramBotAPI/types/MessageEntity/textsources/TextMentionTextSource.kt

@@ -1,15 +1,16 @@
 package com.github.insanusmokrassar.TelegramBotAPI.types.MessageEntity.textsources
 
-import com.github.insanusmokrassar.TelegramBotAPI.CommonAbstracts.TextSource
+import com.github.insanusmokrassar.TelegramBotAPI.CommonAbstracts.*
-import com.github.insanusmokrassar.TelegramBotAPI.types.User
 import com.github.insanusmokrassar.TelegramBotAPI.types.chat.abstracts.PrivateChat
-import com.github.insanusmokrassar.TelegramBotAPI.utils.mentionHTML
+import com.github.insanusmokrassar.TelegramBotAPI.utils.*
-import com.github.insanusmokrassar.TelegramBotAPI.utils.mentionMarkdown
 
 class TextMentionTextSource(
-    override val rawSource: String,
+    source: String,
-    privateChat: PrivateChat
+    privateChat: PrivateChat,
-) : TextSource {
+    textParts: List<TextPart>
-    override val asMarkdownSource: String = rawSource.mentionMarkdown(privateChat.id)
+) : MultilevelTextSource {
-    override val asHtmlSource: String = rawSource.mentionHTML(privateChat.id)
+    override val textParts: List<TextPart> by lazy { source.fullListOfSubSource(textParts) }
+    override val asMarkdownSource: String by lazy { source.textMentionMarkdown(privateChat.id) }
+    override val asMarkdownV2Source: String by lazy { textMentionMarkdownV2(privateChat.id) }
+    override val asHtmlSource: String by lazy { textMentionHTML(privateChat.id) }
 }

src/commonMain/kotlin/com/github/insanusmokrassar/TelegramBotAPI/types/MessageEntity/textsources/URLTextSource.kt

@@ -1,14 +1,12 @@
 package com.github.insanusmokrassar.TelegramBotAPI.types.MessageEntity.textsources
 
 import com.github.insanusmokrassar.TelegramBotAPI.CommonAbstracts.TextSource
-import com.github.insanusmokrassar.TelegramBotAPI.utils.linkHTML
+import com.github.insanusmokrassar.TelegramBotAPI.utils.*
-import com.github.insanusmokrassar.TelegramBotAPI.utils.linkMarkdown
 
 class URLTextSource(
-    override val rawSource: String
+    source: String
 ) : TextSource {
-    override val asMarkdownSource: String
+    override val asMarkdownSource: String by lazy { source.linkMarkdown(source) }
-        get() = rawSource.linkMarkdown(rawSource)
+    override val asMarkdownV2Source: String by lazy { source.linkMarkdownV2(source) }
-    override val asHtmlSource: String
+    override val asHtmlSource: String by lazy { source.linkHTML(source) }
-        get() = rawSource.linkHTML(rawSource)
 }

src/commonMain/kotlin/com/github/insanusmokrassar/TelegramBotAPI/types/MessageEntity/textsources/UnderlineTextSource.kt

@@ -1,14 +1,15 @@
 package com.github.insanusmokrassar.TelegramBotAPI.types.MessageEntity.textsources
 
-import com.github.insanusmokrassar.TelegramBotAPI.CommonAbstracts.TextSource
+import com.github.insanusmokrassar.TelegramBotAPI.CommonAbstracts.MultilevelTextSource
-import com.github.insanusmokrassar.TelegramBotAPI.utils.underlineHTML
+import com.github.insanusmokrassar.TelegramBotAPI.CommonAbstracts.TextPart
-import com.github.insanusmokrassar.TelegramBotAPI.utils.underlineMarkdown
+import com.github.insanusmokrassar.TelegramBotAPI.utils.*
 
 class UnderlineTextSource(
-    override val rawSource: String
+    source: String,
-) : TextSource {
+    textParts: List<TextPart>
-    override val asMarkdownSource: String
+) : MultilevelTextSource {
-        get() = rawSource.underlineMarkdown()
+    override val textParts: List<TextPart> = source.fullListOfSubSource(textParts)
-    override val asHtmlSource: String
+    override val asMarkdownSource: String by lazy { source.underlineMarkdown() }
-        get() = rawSource.underlineHTML()
+    override val asMarkdownV2Source: String by lazy { underlineMarkdownV2() }
+    override val asHtmlSource: String by lazy { underlineHTML() }
 }

src/commonMain/kotlin/com/github/insanusmokrassar/TelegramBotAPI/types/ParseMode/ParseMode.kt

@@ -16,6 +16,12 @@ object MarkdownParseMode : ParseMode() {
     override val parseModeName: String = "Markdown"
 }
 
+@Serializable(ParseModeSerializerObject::class)
+object MarkdownV2ParseMode : ParseMode() {
+    @Serializable
+    @SerialName(parseModeField)
+    override val parseModeName: String = "MarkdownV2"
+}
 @Serializable(ParseModeSerializerObject::class)
 object HTMLParseMode : ParseMode() {
     @Serializable
@@ -24,6 +30,7 @@ object HTMLParseMode : ParseMode() {
 }
 
 typealias Markdown = MarkdownParseMode
+typealias MarkdownV2 = MarkdownV2ParseMode
 typealias HTML = HTMLParseMode
 
 @Serializer(ParseMode::class)

src/commonMain/kotlin/com/github/insanusmokrassar/TelegramBotAPI/types/games/Game.kt

@@ -1,8 +1,6 @@
 package com.github.insanusmokrassar.TelegramBotAPI.types.games
 
-import com.github.insanusmokrassar.TelegramBotAPI.CommonAbstracts.CaptionedInput
+import com.github.insanusmokrassar.TelegramBotAPI.CommonAbstracts.*
-import com.github.insanusmokrassar.TelegramBotAPI.CommonAbstracts.Titled
-import com.github.insanusmokrassar.TelegramBotAPI.types.MessageEntity.MessageEntity
 import com.github.insanusmokrassar.TelegramBotAPI.types.files.AnimationFile
 import com.github.insanusmokrassar.TelegramBotAPI.types.files.Photo
 
@@ -11,6 +9,6 @@ data class Game(
     val description: String,
     val photo: Photo,
     override val caption: String? = null,
-    override val captionEntities: List<MessageEntity> = emptyList(),
+    override val captionEntities: List<TextPart> = emptyList(),
     val animation: AnimationFile? = null
 ) : Titled, CaptionedInput

src/commonMain/kotlin/com/github/insanusmokrassar/TelegramBotAPI/types/games/RawGame.kt

@@ -2,6 +2,7 @@ package com.github.insanusmokrassar.TelegramBotAPI.types.games
 
 import com.github.insanusmokrassar.TelegramBotAPI.types.*
 import com.github.insanusmokrassar.TelegramBotAPI.types.MessageEntity.RawMessageEntities
+import com.github.insanusmokrassar.TelegramBotAPI.types.MessageEntity.asTextParts
 import com.github.insanusmokrassar.TelegramBotAPI.types.files.*
 import kotlinx.serialization.*
 
@@ -27,7 +28,7 @@ internal data class RawGame(
         description,
         photo,
         caption,
-        caption ?.let { _ -> captionEntities.map { it.asMessageEntity(caption) } } ?: emptyList(),
+        caption ?.let { _ -> captionEntities.asTextParts(caption) } ?: emptyList(),
         animation
     )
 }

src/commonMain/kotlin/com/github/insanusmokrassar/TelegramBotAPI/types/message/RawMessage.kt

@@ -2,6 +2,7 @@ package com.github.insanusmokrassar.TelegramBotAPI.types.message
 
 import com.github.insanusmokrassar.TelegramBotAPI.types.*
 import com.github.insanusmokrassar.TelegramBotAPI.types.MessageEntity.RawMessageEntities
+import com.github.insanusmokrassar.TelegramBotAPI.types.MessageEntity.asTextParts
 import com.github.insanusmokrassar.TelegramBotAPI.types.buttons.InlineKeyboardMarkup
 import com.github.insanusmokrassar.TelegramBotAPI.types.chat.abstracts.*
 import com.github.insanusmokrassar.TelegramBotAPI.types.files.*
@@ -85,13 +86,11 @@ internal data class RawMessage(
 ) {
     private val content: MessageContent? by lazy {
         val adaptedCaptionEntities = caption ?.let {
-            caption_entities ?.map {
+            caption_entities ?.asTextParts(caption)
-                it.asMessageEntity(caption)
-            }
         } ?: emptyList()
 
         when {
-            text != null -> TextContent(text, entities ?.map { it.asMessageEntity(text) } ?: emptyList())
+            text != null -> TextContent(text, entities ?.asTextParts(text) ?: emptyList())
             audio != null -> AudioContent(
                 audio,
                 caption,

src/commonMain/kotlin/com/github/insanusmokrassar/TelegramBotAPI/types/message/content/TextContent.kt

@@ -1,20 +1,19 @@
 package com.github.insanusmokrassar.TelegramBotAPI.types.message.content
 
+import com.github.insanusmokrassar.TelegramBotAPI.CommonAbstracts.TextPart
 import com.github.insanusmokrassar.TelegramBotAPI.requests.abstracts.Request
 import com.github.insanusmokrassar.TelegramBotAPI.requests.send.SendMessage
 import com.github.insanusmokrassar.TelegramBotAPI.types.ChatIdentifier
-import com.github.insanusmokrassar.TelegramBotAPI.types.MessageEntity.MessageEntity
 import com.github.insanusmokrassar.TelegramBotAPI.types.MessageIdentifier
 import com.github.insanusmokrassar.TelegramBotAPI.types.ParseMode.*
 import com.github.insanusmokrassar.TelegramBotAPI.types.buttons.KeyboardMarkup
 import com.github.insanusmokrassar.TelegramBotAPI.types.message.abstracts.Message
 import com.github.insanusmokrassar.TelegramBotAPI.types.message.content.abstracts.MessageContent
-import com.github.insanusmokrassar.TelegramBotAPI.utils.toHtmlTexts
+import com.github.insanusmokrassar.TelegramBotAPI.utils.*
-import com.github.insanusmokrassar.TelegramBotAPI.utils.toMarkdownTexts
 
 data class TextContent(
     val text: String,
-    val entities: List<MessageEntity> = emptyList()
+    val entities: List<TextPart> = emptyList()
 ) : MessageContent {
     override fun createResend(
         chatId: ChatIdentifier,
@@ -52,6 +51,7 @@ data class TextContent(
         parseMode: ParseMode = HTMLParseMode
     ): List<Request<Message>> = when (parseMode) {
         is MarkdownParseMode -> toMarkdownTexts()
+        is MarkdownV2ParseMode -> toMarkdownV2Texts()
         is HTMLParseMode -> toHtmlTexts()
     }.map {
         SendMessage(
@@ -65,3 +65,5 @@ data class TextContent(
         )
     }
 }
+
+fun TextContent.fullEntitiesList() = text.fullListOfSubSource(entities).map { it.source }

src/commonMain/kotlin/com/github/insanusmokrassar/TelegramBotAPI/types/message/content/media/AnimationContent.kt

@@ -1,10 +1,10 @@
 package com.github.insanusmokrassar.TelegramBotAPI.types.message.content.media
 
 import com.github.insanusmokrassar.TelegramBotAPI.CommonAbstracts.CaptionedInput
+import com.github.insanusmokrassar.TelegramBotAPI.CommonAbstracts.TextPart
 import com.github.insanusmokrassar.TelegramBotAPI.requests.abstracts.Request
 import com.github.insanusmokrassar.TelegramBotAPI.requests.send.media.SendAnimation
 import com.github.insanusmokrassar.TelegramBotAPI.types.ChatIdentifier
-import com.github.insanusmokrassar.TelegramBotAPI.types.MessageEntity.MessageEntity
 import com.github.insanusmokrassar.TelegramBotAPI.types.MessageIdentifier
 import com.github.insanusmokrassar.TelegramBotAPI.types.ParseMode.HTMLParseMode
 import com.github.insanusmokrassar.TelegramBotAPI.types.buttons.KeyboardMarkup
@@ -18,7 +18,7 @@ data class AnimationContent(
     override val media: AnimationFile,
     val includedDocument: DocumentFile?,
     override val caption: String?,
-    override val captionEntities: List<MessageEntity>
+    override val captionEntities: List<TextPart>
 ) : MediaContent, CaptionedInput {
     override fun createResend(
         chatId: ChatIdentifier,

src/commonMain/kotlin/com/github/insanusmokrassar/TelegramBotAPI/types/message/content/media/AudioContent.kt

@@ -1,10 +1,10 @@
 package com.github.insanusmokrassar.TelegramBotAPI.types.message.content.media
 
 import com.github.insanusmokrassar.TelegramBotAPI.CommonAbstracts.CaptionedInput
+import com.github.insanusmokrassar.TelegramBotAPI.CommonAbstracts.TextPart
 import com.github.insanusmokrassar.TelegramBotAPI.requests.abstracts.Request
 import com.github.insanusmokrassar.TelegramBotAPI.requests.send.media.SendAudio
 import com.github.insanusmokrassar.TelegramBotAPI.types.ChatIdentifier
-import com.github.insanusmokrassar.TelegramBotAPI.types.MessageEntity.MessageEntity
 import com.github.insanusmokrassar.TelegramBotAPI.types.MessageIdentifier
 import com.github.insanusmokrassar.TelegramBotAPI.types.ParseMode.HTMLParseMode
 import com.github.insanusmokrassar.TelegramBotAPI.types.buttons.KeyboardMarkup
@@ -16,7 +16,7 @@ import com.github.insanusmokrassar.TelegramBotAPI.utils.toHtmlCaptions
 data class AudioContent(
     override val media: AudioFile,
     override val caption: String? = null,
-    override val captionEntities: List<MessageEntity> = emptyList()
+    override val captionEntities: List<TextPart> = emptyList()
 ) : MediaContent, CaptionedInput {
     override fun createResend(
         chatId: ChatIdentifier,

src/commonMain/kotlin/com/github/insanusmokrassar/TelegramBotAPI/types/message/content/media/DocumentContent.kt

@@ -1,10 +1,10 @@
 package com.github.insanusmokrassar.TelegramBotAPI.types.message.content.media
 
 import com.github.insanusmokrassar.TelegramBotAPI.CommonAbstracts.CaptionedInput
+import com.github.insanusmokrassar.TelegramBotAPI.CommonAbstracts.TextPart
 import com.github.insanusmokrassar.TelegramBotAPI.requests.abstracts.Request
 import com.github.insanusmokrassar.TelegramBotAPI.requests.send.media.SendDocument
 import com.github.insanusmokrassar.TelegramBotAPI.types.ChatIdentifier
-import com.github.insanusmokrassar.TelegramBotAPI.types.MessageEntity.MessageEntity
 import com.github.insanusmokrassar.TelegramBotAPI.types.MessageIdentifier
 import com.github.insanusmokrassar.TelegramBotAPI.types.ParseMode.HTMLParseMode
 import com.github.insanusmokrassar.TelegramBotAPI.types.buttons.KeyboardMarkup
@@ -16,7 +16,7 @@ import com.github.insanusmokrassar.TelegramBotAPI.utils.toHtmlCaptions
 data class DocumentContent(
     override val media: DocumentFile,
     override val caption: String? = null,
-    override val captionEntities: List<MessageEntity> = emptyList()
+    override val captionEntities: List<TextPart> = emptyList()
 ) : MediaContent, CaptionedInput {
     override fun createResend(
         chatId: ChatIdentifier,

src/commonMain/kotlin/com/github/insanusmokrassar/TelegramBotAPI/types/message/content/media/PhotoContent.kt

@@ -1,11 +1,11 @@
 package com.github.insanusmokrassar.TelegramBotAPI.types.message.content.media
 
+import com.github.insanusmokrassar.TelegramBotAPI.CommonAbstracts.TextPart
 import com.github.insanusmokrassar.TelegramBotAPI.requests.abstracts.Request
 import com.github.insanusmokrassar.TelegramBotAPI.requests.send.media.SendPhoto
 import com.github.insanusmokrassar.TelegramBotAPI.types.ChatIdentifier
 import com.github.insanusmokrassar.TelegramBotAPI.types.InputMedia.InputMediaPhoto
 import com.github.insanusmokrassar.TelegramBotAPI.types.InputMedia.MediaGroupMemberInputMedia
-import com.github.insanusmokrassar.TelegramBotAPI.types.MessageEntity.MessageEntity
 import com.github.insanusmokrassar.TelegramBotAPI.types.MessageIdentifier
 import com.github.insanusmokrassar.TelegramBotAPI.types.ParseMode.HTMLParseMode
 import com.github.insanusmokrassar.TelegramBotAPI.types.buttons.KeyboardMarkup
@@ -19,7 +19,7 @@ import com.github.insanusmokrassar.TelegramBotAPI.utils.toHtmlCaptions
 data class PhotoContent(
     override val mediaCollection: List<PhotoSize>,
     override val caption: String? = null,
-    override val captionEntities: List<MessageEntity> = emptyList()
+    override val captionEntities: List<TextPart> = emptyList()
 ) : MediaCollectionContent<PhotoSize>, MediaGroupContent {
     override val media: PhotoSize = mediaCollection.biggest() ?: throw IllegalStateException("Can't locate any photo size for this content")
 

src/commonMain/kotlin/com/github/insanusmokrassar/TelegramBotAPI/types/message/content/media/VideoContent.kt

@@ -1,11 +1,11 @@
 package com.github.insanusmokrassar.TelegramBotAPI.types.message.content.media
 
+import com.github.insanusmokrassar.TelegramBotAPI.CommonAbstracts.TextPart
 import com.github.insanusmokrassar.TelegramBotAPI.requests.abstracts.Request
 import com.github.insanusmokrassar.TelegramBotAPI.requests.send.media.SendVideo
 import com.github.insanusmokrassar.TelegramBotAPI.types.ChatIdentifier
 import com.github.insanusmokrassar.TelegramBotAPI.types.InputMedia.InputMediaVideo
 import com.github.insanusmokrassar.TelegramBotAPI.types.InputMedia.MediaGroupMemberInputMedia
-import com.github.insanusmokrassar.TelegramBotAPI.types.MessageEntity.MessageEntity
 import com.github.insanusmokrassar.TelegramBotAPI.types.MessageIdentifier
 import com.github.insanusmokrassar.TelegramBotAPI.types.ParseMode.HTMLParseMode
 import com.github.insanusmokrassar.TelegramBotAPI.types.buttons.KeyboardMarkup
@@ -17,7 +17,7 @@ import com.github.insanusmokrassar.TelegramBotAPI.utils.toHtmlCaptions
 data class VideoContent(
     override val media: VideoFile,
     override val caption: String? = null,
-    override val captionEntities: List<MessageEntity> = emptyList()
+    override val captionEntities: List<TextPart> = emptyList()
 ) : MediaGroupContent {
     override fun createResend(
         chatId: ChatIdentifier,

src/commonMain/kotlin/com/github/insanusmokrassar/TelegramBotAPI/types/message/content/media/VoiceContent.kt

@@ -1,10 +1,10 @@
 package com.github.insanusmokrassar.TelegramBotAPI.types.message.content.media
 
 import com.github.insanusmokrassar.TelegramBotAPI.CommonAbstracts.CaptionedInput
+import com.github.insanusmokrassar.TelegramBotAPI.CommonAbstracts.TextPart
 import com.github.insanusmokrassar.TelegramBotAPI.requests.abstracts.Request
 import com.github.insanusmokrassar.TelegramBotAPI.requests.send.media.SendVoice
 import com.github.insanusmokrassar.TelegramBotAPI.types.ChatIdentifier
-import com.github.insanusmokrassar.TelegramBotAPI.types.MessageEntity.MessageEntity
 import com.github.insanusmokrassar.TelegramBotAPI.types.MessageIdentifier
 import com.github.insanusmokrassar.TelegramBotAPI.types.ParseMode.HTMLParseMode
 import com.github.insanusmokrassar.TelegramBotAPI.types.buttons.KeyboardMarkup
@@ -16,7 +16,7 @@ import com.github.insanusmokrassar.TelegramBotAPI.utils.toHtmlCaptions
 data class VoiceContent(
     override val media: VoiceFile,
     override val caption: String? = null,
-    override val captionEntities: List<MessageEntity> = emptyList()
+    override val captionEntities: List<TextPart> = emptyList()
 ) : MediaContent, CaptionedInput {
     override fun createResend(
         chatId: ChatIdentifier,

src/commonMain/kotlin/com/github/insanusmokrassar/TelegramBotAPI/utils/CaptionAndTextSourcesToText.kt

@@ -0,0 +1,98 @@
+package com.github.insanusmokrassar.TelegramBotAPI.utils
+
+import com.github.insanusmokrassar.TelegramBotAPI.CommonAbstracts.*
+import com.github.insanusmokrassar.TelegramBotAPI.types.ParseMode.*
+import com.github.insanusmokrassar.TelegramBotAPI.types.captionLength
+import com.github.insanusmokrassar.TelegramBotAPI.types.message.content.TextContent
+import com.github.insanusmokrassar.TelegramBotAPI.types.message.content.fullEntitiesList
+import com.github.insanusmokrassar.TelegramBotAPI.types.textLength
+
+fun createFormattedText(
+    entities: List<TextSource>,
+    partLength: Int = 4096,
+    mode: ParseMode = MarkdownParseMode
+): List<String> {
+    val texts = mutableListOf<String>()
+    val textBuilder = StringBuilder(partLength)
+    for (entity in entities) {
+        val string = when (mode) {
+            is MarkdownParseMode -> entity.asMarkdownSource
+            is MarkdownV2ParseMode -> entity.asMarkdownV2Source
+            is HTMLParseMode -> entity.asHtmlSource
+        }
+        if (textBuilder.length + string.length > partLength) {
+            if (textBuilder.isNotEmpty()) {
+                texts.add(textBuilder.toString())
+                textBuilder.clear()
+            }
+            val chunked = string.chunked(partLength)
+            val last = chunked.last()
+            textBuilder.append(last)
+            val listToAdd = if (chunked.size > 1) {
+                chunked.subList(0, chunked.size - 1)
+            } else {
+                emptyList()
+            }
+            listToAdd.forEach {
+                texts.add(it)
+            }
+        } else {
+            textBuilder.append(string)
+        }
+    }
+    if (textBuilder.isNotEmpty()) {
+        texts.add(textBuilder.toString())
+        textBuilder.clear()
+    }
+    return texts
+}
+
+
+fun createMarkdownText(
+    entities: List<TextSource>,
+    partLength: Int = 4096
+): List<String> = createFormattedText(entities, partLength, MarkdownParseMode)
+
+fun CaptionedInput.toMarkdownCaptions(): List<String> = createMarkdownText(
+    fullEntitiesList(),
+    captionLength.last + 1
+)
+
+fun TextContent.toMarkdownTexts(): List<String> = createMarkdownText(
+    fullEntitiesList(),
+    textLength.last + 1
+)
+
+
+fun createMarkdownV2Text(
+    entities: List<TextSource>,
+    partLength: Int = 4096
+): List<String> = createFormattedText(entities, partLength, MarkdownV2ParseMode)
+
+fun CaptionedInput.toMarkdownV2Captions(): List<String> = createMarkdownV2Text(
+    fullEntitiesList(),
+    captionLength.last + 1
+)
+
+fun TextContent.toMarkdownV2Texts(): List<String> = createMarkdownV2Text(
+    fullEntitiesList(),
+    textLength.last + 1
+)
+
+
+fun createHtmlText(
+    entities: List<TextSource>,
+    partLength: Int = 4096
+): List<String> = createFormattedText(entities, partLength, HTMLParseMode)
+
+fun CaptionedInput.toHtmlCaptions(): List<String> = createHtmlText(
+    fullEntitiesList(),
+    captionLength.last + 1
+)
+
+fun TextContent.toHtmlTexts(): List<String> = createHtmlText(
+    fullEntitiesList(),
+    textLength.last + 1
+)
+
+

src/commonMain/kotlin/com/github/insanusmokrassar/TelegramBotAPI/utils/Captions.kt

@@ -1,77 +0,0 @@
-package com.github.insanusmokrassar.TelegramBotAPI.utils
-
-import com.github.insanusmokrassar.TelegramBotAPI.CommonAbstracts.CaptionedInput
-import com.github.insanusmokrassar.TelegramBotAPI.CommonAbstracts.TextSource
-import com.github.insanusmokrassar.TelegramBotAPI.types.MessageEntity.MessageEntity
-import com.github.insanusmokrassar.TelegramBotAPI.types.MessageEntity.RegularTextMessageEntity
-import com.github.insanusmokrassar.TelegramBotAPI.types.ParseMode.*
-import com.github.insanusmokrassar.TelegramBotAPI.types.message.content.TextContent
-
-fun CaptionedInput.fullEntitiesList(): List<MessageEntity> = caption ?.let {
-    convertToFullMessageEntityList(it, captionEntities)
-} ?: emptyList()
-
-fun TextContent.fullEntitiesList(): List<MessageEntity> = convertToFullMessageEntityList(text, entities)
-
-fun convertToFullMessageEntityList(
-    text: String,
-    messageEntities: List<MessageEntity>
-): List<MessageEntity> {
-    val result = mutableListOf<MessageEntity>()
-
-    var offset = 0
-    for (entity in messageEntities) {
-        val newEntitySize = entity.offset - offset
-        if (newEntitySize > 0) {
-            val regularEntity = RegularTextMessageEntity(offset, newEntitySize, text.substring(offset, entity.offset))
-            result.add(regularEntity)
-            offset += regularEntity.length
-        }
-        result.add(entity)
-        offset += entity.length
-    }
-    val newEntitySize = text.length - offset
-    if (newEntitySize > 0) {
-        result.add(RegularTextMessageEntity(offset, newEntitySize, text.substring(offset, text.length)))
-    }
-    return result
-}
-
-fun createFormattedText(
-    entities: List<TextSource>,
-    partLength: Int = 4096,
-    mode: ParseMode = MarkdownParseMode
-): List<String> {
-    val texts = mutableListOf<String>()
-    val textBuilder = StringBuilder(partLength)
-    for (entity in entities) {
-        val string = when (mode) {
-            is MarkdownParseMode -> entity.asMarkdownSource
-            is HTMLParseMode -> entity.asHtmlSource
-        }
-        if (textBuilder.length + string.length > partLength) {
-            if (textBuilder.isNotEmpty()) {
-                texts.add(textBuilder.toString())
-                textBuilder.clear()
-            }
-            val chunked = string.chunked(partLength)
-            val last = chunked.last()
-            textBuilder.append(last)
-            val listToAdd = if (chunked.size > 1) {
-                chunked.subList(0, chunked.size - 1)
-            } else {
-                emptyList()
-            }
-            listToAdd.forEach {
-                texts.add(it)
-            }
-        } else {
-            textBuilder.append(string)
-        }
-    }
-    if (textBuilder.isNotEmpty()) {
-        texts.add(textBuilder.toString())
-        textBuilder.clear()
-    }
-    return texts
-}

src/commonMain/kotlin/com/github/insanusmokrassar/TelegramBotAPI/utils/HtmlCaptionSourcer.kt

@@ -1,24 +0,0 @@
-package com.github.insanusmokrassar.TelegramBotAPI.utils
-
-import com.github.insanusmokrassar.TelegramBotAPI.CommonAbstracts.CaptionedInput
-import com.github.insanusmokrassar.TelegramBotAPI.CommonAbstracts.TextSource
-import com.github.insanusmokrassar.TelegramBotAPI.types.MessageEntity.MessageEntity
-import com.github.insanusmokrassar.TelegramBotAPI.types.ParseMode.HTMLParseMode
-import com.github.insanusmokrassar.TelegramBotAPI.types.captionLength
-import com.github.insanusmokrassar.TelegramBotAPI.types.message.content.TextContent
-import com.github.insanusmokrassar.TelegramBotAPI.types.textLength
-
-fun createHtmlText(
-    entities: List<TextSource>,
-    partLength: Int = 4096
-): List<String> = createFormattedText(entities, partLength, HTMLParseMode)
-
-fun CaptionedInput.toHtmlCaptions(): List<String> = createHtmlText(
-    fullEntitiesList(),
-    captionLength.endInclusive + 1
-)
-
-fun TextContent.toHtmlTexts(): List<String> = createHtmlText(
-    fullEntitiesList(),
-    textLength.endInclusive + 1
-)

src/commonMain/kotlin/com/github/insanusmokrassar/TelegramBotAPI/utils/MarkdownCaptionSourcer.kt

@@ -1,24 +0,0 @@
-package com.github.insanusmokrassar.TelegramBotAPI.utils
-
-import com.github.insanusmokrassar.TelegramBotAPI.CommonAbstracts.CaptionedInput
-import com.github.insanusmokrassar.TelegramBotAPI.CommonAbstracts.TextSource
-import com.github.insanusmokrassar.TelegramBotAPI.types.MessageEntity.MessageEntity
-import com.github.insanusmokrassar.TelegramBotAPI.types.ParseMode.MarkdownParseMode
-import com.github.insanusmokrassar.TelegramBotAPI.types.captionLength
-import com.github.insanusmokrassar.TelegramBotAPI.types.message.content.TextContent
-import com.github.insanusmokrassar.TelegramBotAPI.types.textLength
-
-fun createMarkdownText(
-    entities: List<TextSource>,
-    partLength: Int = 4096
-): List<String> = createFormattedText(entities, partLength, MarkdownParseMode)
-
-fun CaptionedInput.toMarkdownCaptions(): List<String> = createMarkdownText(
-    fullEntitiesList(),
-    captionLength.endInclusive + 1
-)
-
-fun TextContent.toMarkdownTexts(): List<String> = createMarkdownText(
-    fullEntitiesList(),
-    textLength.endInclusive + 1
-)

src/commonMain/kotlin/com/github/insanusmokrassar/TelegramBotAPI/utils/MultilevelTextSourceFormatting.kt

@@ -0,0 +1,137 @@
+package com.github.insanusmokrassar.TelegramBotAPI.utils
+
+import com.github.insanusmokrassar.TelegramBotAPI.CommonAbstracts.*
+import com.github.insanusmokrassar.TelegramBotAPI.types.MessageEntity.textsources.*
+import com.github.insanusmokrassar.TelegramBotAPI.types.UserId
+import com.github.insanusmokrassar.TelegramBotAPI.types.link
+import com.github.insanusmokrassar.TelegramBotAPI.utils.extensions.*
+
+internal fun String.fullListOfSubSource(sourceList: List<TextPart>): List<TextPart> {
+    val sortedSourceList = sourceList.sortedBy { it.range.first }.toMutableList()
+
+    var previousLastIndex = 0
+
+    val newSubSources = mutableListOf<TextPart>()
+
+    while (sortedSourceList.isNotEmpty()) {
+        val topSource = sortedSourceList.removeAt(0)
+        if (topSource.range.first - previousLastIndex > 0) {
+            val range = previousLastIndex until topSource.range.first
+            newSubSources.add(
+                TextPart(
+                    range,
+                    RegularTextSource(
+                        substring(range)
+                    )
+                )
+            )
+        }
+        newSubSources.add(topSource)
+        previousLastIndex = topSource.range.last + 1
+    }
+
+    if (length > previousLastIndex) {
+        val range = previousLastIndex until length
+        newSubSources.add(
+            TextPart(
+                range,
+                RegularTextSource(
+                    substring(range)
+                )
+            )
+        )
+    }
+
+    return newSubSources
+}
+
+internal fun List<TextPart>.shiftSourcesToTheLeft(shiftCount: Int = 1): List<TextPart> {
+    return mapNotNull {
+        val first = (it.range.first - shiftCount).let { firstCalculated ->
+            if (firstCalculated < 0) {
+                0
+            } else {
+                firstCalculated
+            }
+        }
+        val last = (it.range.last - shiftCount).let { lastCalculated ->
+            if (lastCalculated < 0) {
+                0
+            } else {
+                lastCalculated
+            }
+        }
+        it.copy(range = first .. last).let { newSubSource ->
+            if (newSubSource.range.isEmpty()) {
+                null
+            } else {
+                newSubSource
+            }
+        }
+    }
+}
+
+private fun List<TextPart>.joinSubSourcesMarkdownV2() = joinToString("") {
+    it.source.asMarkdownV2Source
+}
+
+private fun List<TextPart>.joinSubSourcesHtml() = joinToString("") {
+    it.source.asHtmlSource
+}
+
+internal fun MultilevelTextSource.markdownV2Default(
+    openControlSymbol: String,
+    closeControlSymbol: String = openControlSymbol
+) = "$openControlSymbol${textParts.joinSubSourcesMarkdownV2()}$closeControlSymbol"
+internal fun MultilevelTextSource.htmlDefault(
+    openControlSymbol: String,
+    closeControlSymbol: String = openControlSymbol
+) = "<$openControlSymbol>${textParts.joinSubSourcesHtml()}</$closeControlSymbol>"
+
+
+internal fun MultilevelTextSource.linkMarkdownV2(
+    link: String
+) = "[${textParts.joinSubSourcesMarkdownV2()}](${link.escapeMarkdownV2Link()})"
+internal fun MultilevelTextSource.linkHTML(
+    link: String
+) = "<a href=\"${link.toHtml()}\">${textParts.joinSubSourcesHtml()}</a>"
+
+
+internal fun MultilevelTextSource.emailMarkdownV2(address: String): String = linkMarkdownV2("mailto://$address")
+internal fun MultilevelTextSource.emailHTML(address: String): String = linkHTML("mailto://$address}")
+
+
+internal fun MultilevelTextSource.boldMarkdownV2(): String = markdownV2Default(markdownBoldControl)
+internal fun MultilevelTextSource.boldHTML(): String = htmlDefault(htmlBoldControl)
+
+
+internal fun MultilevelTextSource.italicMarkdownV2(): String = markdownV2Default(markdownItalicControl)
+internal fun MultilevelTextSource.italicHTML(): String = htmlDefault(htmlItalicControl)
+
+
+internal fun MultilevelTextSource.strikethroughMarkdownV2(): String = markdownV2Default(markdownV2StrikethroughControl)
+internal fun MultilevelTextSource.strikethroughHTML(): String = htmlDefault(htmlStrikethroughControl)
+
+
+internal fun MultilevelTextSource.underlineMarkdownV2(): String = markdownV2Default(markdownV2UnderlineControl)
+internal fun MultilevelTextSource.underlineHTML(): String = htmlDefault(htmlUnderlineControl)
+
+
+internal fun MultilevelTextSource.textMentionMarkdownV2(userId: UserId): String = linkMarkdownV2(userId.link)
+internal fun MultilevelTextSource.textMentionHTML(userId: UserId): String = linkHTML(userId.link)
+
+internal fun MultilevelTextSource.mentionMarkdownV2(): String = "@${textParts.joinSubSourcesMarkdownV2()}"
+internal fun MultilevelTextSource.mentionHTML(): String = "@${textParts.joinSubSourcesHtml()}"
+
+
+internal fun MultilevelTextSource.hashTagMarkdownV2(): String = "#${textParts.joinSubSourcesMarkdownV2()}"
+internal fun MultilevelTextSource.hashTagHTML(): String = "#${textParts.joinSubSourcesHtml()}"
+
+
+internal fun MultilevelTextSource.phoneMarkdownV2(): String = textParts.joinSubSourcesMarkdownV2()
+internal fun MultilevelTextSource.phoneHTML(): String = textParts.joinSubSourcesHtml()
+
+
+internal fun MultilevelTextSource.commandMarkdownV2(): String = "/${textParts.joinSubSourcesMarkdownV2()}"
+internal fun MultilevelTextSource.commandHTML(): String = "/${textParts.joinSubSourcesHtml()}"
+

src/commonMain/kotlin/com/github/insanusmokrassar/TelegramBotAPI/utils/StringFormatting.kt

@@ -2,14 +2,19 @@ package com.github.insanusmokrassar.TelegramBotAPI.utils
 
 import com.github.insanusmokrassar.TelegramBotAPI.types.*
 import com.github.insanusmokrassar.TelegramBotAPI.types.ParseMode.*
-import com.github.insanusmokrassar.TelegramBotAPI.utils.extensions.toHtml
+import com.github.insanusmokrassar.TelegramBotAPI.utils.extensions.*
-import com.github.insanusmokrassar.TelegramBotAPI.utils.extensions.toMarkdown
 
 const val markdownBoldControl = "*"
 const val markdownItalicControl = "_"
 const val markdownCodeControl = "`"
 const val markdownPreControl = "```"
 
+const val markdownV2ItalicUnderlineDelimiter = "\u0013"
+const val markdownV2StrikethroughControl = "~"
+const val markdownV2UnderlineControl = "__"
+const val markdownV2UnderlineEndControl = "$markdownV2UnderlineControl$markdownV2ItalicUnderlineDelimiter"
+const val markdownV2ItalicEndControl = "$markdownItalicControl$markdownV2ItalicUnderlineDelimiter"
+
 const val htmlBoldControl = "b"
 const val htmlItalicControl = "i"
 const val htmlCodeControl = "code"
@@ -21,48 +26,35 @@ private fun String.markdownDefault(
     openControlSymbol: String,
     closeControlSymbol: String = openControlSymbol
 ) = "$openControlSymbol${toMarkdown()}$closeControlSymbol"
+private fun String.markdownV2Default(
+    openControlSymbol: String,
+    closeControlSymbol: String = openControlSymbol,
+    escapeFun: String.() -> String = String::escapeMarkdownV2Common
+) = "$openControlSymbol${escapeFun()}$closeControlSymbol"
 private fun String.htmlDefault(
     openControlSymbol: String,
     closeControlSymbol: String = openControlSymbol
 ) = "<$openControlSymbol>${toHtml()}</$closeControlSymbol>"
 
-fun String.linkMarkdown(link: String): String = "[${toMarkdown()}]($link)"
+fun String.linkMarkdown(link: String): String = "[${toMarkdown()}](${link.toMarkdown()})"
+fun String.linkMarkdownV2(link: String): String = "[${escapeMarkdownV2Common()}](${link.escapeMarkdownV2Link()})"
 fun String.linkHTML(link: String): String = "<a href=\"$link\">${toHtml()}</a>"
 
 
 fun String.boldMarkdown(): String = markdownDefault(markdownBoldControl)
+fun String.boldMarkdownV2(): String = markdownV2Default(markdownBoldControl)
 fun String.boldHTML(): String = htmlDefault(htmlBoldControl)
 
 
 fun String.italicMarkdown(): String = markdownDefault(markdownItalicControl)
+fun String.italicMarkdownV2(): String = markdownV2Default(markdownItalicControl, markdownV2ItalicEndControl)
 fun String.italicHTML(): String = htmlDefault(htmlItalicControl)
 
-
-fun String.codeMarkdown(): String = markdownDefault(markdownCodeControl)
-fun String.codeHTML(): String = htmlDefault(htmlCodeControl)
-
-
-fun String.preMarkdown(language: String? = null): String = markdownDefault(
-    "$markdownPreControl${language ?.let { "$it\n" } ?: "\n"}",
-    "\n$markdownPreControl"
-)
-fun String.preHTML(language: String? = null): String = htmlDefault(
-    language ?.let { _ ->
-        "$htmlPreControl><$htmlCodeControl class=\"language-$language\""
-    } ?: htmlPreControl,
-    language ?.let { _ ->
-        "$htmlCodeControl></$htmlPreControl"
-    } ?: htmlPreControl
-)
-
-
-fun String.emailMarkdown(): String = linkMarkdown("mailto://$${toMarkdown()}")
-fun String.emailHTML(): String = linkHTML("mailto://$${toHtml()}")
-
 /**
  * Crutch for support of strikethrough in default markdown. Simply add modifier, but it will not look like correct
  */
 fun String.strikethroughMarkdown(): String = map { it + "\u0336" }.joinToString("")
+fun String.strikethroughMarkdownV2(): String = markdownV2Default(markdownV2StrikethroughControl)
 fun String.strikethroughHTML(): String = htmlDefault(htmlStrikethroughControl)
 
 
@@ -70,9 +62,39 @@ fun String.strikethroughHTML(): String = htmlDefault(htmlStrikethroughControl)
  * Crutch for support of underline in default markdown. Simply add modifier, but it will not look like correct
  */
 fun String.underlineMarkdown(): String = map { it + "\u0347" }.joinToString("")
+fun String.underlineMarkdownV2(): String = markdownV2Default(markdownV2UnderlineControl, markdownV2UnderlineEndControl)
 fun String.underlineHTML(): String = htmlDefault(htmlUnderlineControl)
 
 
+fun String.codeMarkdown(): String = markdownDefault(markdownCodeControl)
+fun String.codeMarkdownV2(): String = markdownV2Default(markdownCodeControl, escapeFun = String::escapeMarkdownV2PreAndCode)
+fun String.codeHTML(): String = htmlDefault(htmlCodeControl)
+
+
+fun String.preMarkdown(language: String? = null): String = markdownDefault(
+    "$markdownPreControl${language ?: ""}\n",
+    "\n$markdownPreControl"
+)
+fun String.preMarkdownV2(language: String? = null): String = markdownV2Default(
+    "$markdownPreControl${language ?: ""}\n",
+    "\n$markdownPreControl",
+    String::escapeMarkdownV2PreAndCode
+)
+fun String.preHTML(language: String? = null): String = htmlDefault(
+    language ?.let {
+        "$htmlPreControl><$htmlCodeControl class=\"language-$language\""
+    } ?: htmlPreControl,
+    language ?.let {
+        "$htmlCodeControl></$htmlPreControl"
+    } ?: htmlPreControl
+)
+
+
+fun String.emailMarkdown(): String = linkMarkdown("mailto://$${toMarkdown()}")
+fun String.emailMarkdownV2(): String = linkMarkdownV2("mailto://$${toMarkdown()}")
+fun String.emailHTML(): String = linkHTML("mailto://$${toHtml()}")
+
+
 private inline fun String.mention(adapt: String.() -> String): String = if (startsWith("@")) {
     adapt()
 } else {
@@ -87,19 +109,23 @@ private inline fun String.hashTag(adapt: String.() -> String): String = if (star
 }
 
 
-fun String.mentionMarkdown(userId: UserId): String = linkMarkdown(userId.link)
+fun String.textMentionMarkdown(userId: UserId): String = linkMarkdown(userId.link)
-fun String.mentionHTML(userId: UserId): String = linkHTML(userId.link)
+fun String.textMentionMarkdownV2(userId: UserId): String = linkMarkdownV2(userId.link)
+fun String.textMentionHTML(userId: UserId): String = linkHTML(userId.link)
 
 
 fun String.mentionMarkdown(): String = mention(String::toMarkdown)
+fun String.mentionMarkdownV2(): String = mention(String::escapeMarkdownV2Common)
 fun String.mentionHTML(): String = mention(String::toHtml)
 
 
 fun String.hashTagMarkdown(): String = hashTag(String::toMarkdown)
+fun String.hashTagMarkdownV2(): String = hashTag(String::escapeMarkdownV2Common)
 fun String.hashTagHTML(): String = hashTag(String::toHtml)
 
 
 fun String.phoneMarkdown(): String = toMarkdown()
+fun String.phoneMarkdownV2(): String = escapeMarkdownV2Common()
 fun String.phoneHTML(): String = toHtml()
 
 
@@ -110,70 +136,97 @@ fun String.command(adapt: String.() -> String): String = if (startsWith("/")) {
 }
 
 fun String.commandMarkdown(): String = command(String::toMarkdown)
+fun String.commandMarkdownV2(): String = command(String::escapeMarkdownV2Common)
 fun String.commandHTML(): String = command(String::toHtml)
 
 
 fun String.regularMarkdown(): String = toMarkdown()
+fun String.regularMarkdownV2(): String = escapeMarkdownV2Common()
 fun String.regularHtml(): String = toHtml()
 
 
 infix fun String.bold(parseMode: ParseMode): String = when (parseMode) {
     is HTML -> boldHTML()
     is Markdown -> boldMarkdown()
+    is MarkdownV2 -> boldMarkdownV2()
 }
 
 
 infix fun String.italic(parseMode: ParseMode): String = when (parseMode) {
     is HTML -> italicHTML()
     is Markdown -> italicMarkdown()
+    is MarkdownV2 -> italicMarkdownV2()
 }
 
 infix fun String.hashTag(parseMode: ParseMode): String = when (parseMode) {
     is HTML -> hashTagHTML()
     is Markdown -> hashTagMarkdown()
+    is MarkdownV2 -> hashTagMarkdownV2()
 }
 
 infix fun String.code(parseMode: ParseMode): String = when (parseMode) {
     is HTML -> codeHTML()
     is Markdown -> codeMarkdown()
-}
+    is MarkdownV2 -> codeMarkdownV2()
-
-infix fun String.pre(parseMode: ParseMode): String = when (parseMode) {
-    is HTML -> preHTML()
-    is Markdown -> preMarkdown()
 }
 
 fun String.pre(parseMode: ParseMode, language: String? = null): String = when (parseMode) {
     is HTML -> preHTML(language)
     is Markdown -> preMarkdown(language)
+    is MarkdownV2 -> preMarkdownV2(language)
 }
+infix fun String.pre(parseMode: ParseMode): String = pre(parseMode, null)
 
 infix fun String.email(parseMode: ParseMode): String = when (parseMode) {
     is HTML -> emailHTML()
     is Markdown -> emailMarkdown()
+    is MarkdownV2 -> emailMarkdownV2()
 }
 
 infix fun Pair<String, String>.link(parseMode: ParseMode): String = when (parseMode) {
     is HTML -> first.linkHTML(second)
     is Markdown -> first.linkMarkdown(second)
+    is MarkdownV2 -> first.linkMarkdownV2(second)
 }
 
 infix fun String.mention(parseMode: ParseMode): String = when (parseMode) {
     is HTML -> mentionHTML()
     is Markdown -> mentionMarkdown()
+    is MarkdownV2 -> mentionMarkdownV2()
 }
 
 infix fun Pair<String, ChatId>.mention(parseMode: ParseMode): String = when (parseMode) {
-    is HTML -> first.mentionHTML(second)
+    is HTML -> first.textMentionHTML(second)
-    is Markdown -> first.mentionMarkdown(second)
+    is Markdown -> first.textMentionMarkdown(second)
+    is MarkdownV2 -> first.textMentionMarkdownV2(second)
 }
 
 infix fun String.phone(parseMode: ParseMode): String = when (parseMode) {
     is HTML -> phoneHTML()
     is Markdown -> phoneMarkdown()
+    is MarkdownV2 -> phoneMarkdownV2()
 }
 
 infix fun String.command(parseMode: ParseMode): String = when (parseMode) {
     is HTML -> commandHTML()
     is Markdown -> commandMarkdown()
+    is MarkdownV2 -> commandMarkdownV2()
+}
+
+infix fun String.underline(parseMode: ParseMode): String = when (parseMode) {
+    is HTML -> underlineHTML()
+    is Markdown -> underlineMarkdown()
+    is MarkdownV2 -> underlineMarkdownV2()
+}
+
+infix fun String.strikethrough(parseMode: ParseMode): String = when (parseMode) {
+    is HTML -> strikethroughHTML()
+    is Markdown -> strikethroughMarkdown()
+    is MarkdownV2 -> strikethroughMarkdownV2()
+}
+
+infix fun String.regular(parseMode: ParseMode): String = when (parseMode) {
+    is HTML -> regularHtml()
+    is Markdown -> regularMarkdown()
+    is MarkdownV2 -> regularMarkdownV2()
 }

src/commonMain/kotlin/com/github/insanusmokrassar/TelegramBotAPI/utils/extensions/String.kt

@@ -16,6 +16,33 @@ fun String.toMarkdown(): String {
     )
 }
 
+private val markdownV2LinkEscapes = mutableSetOf(')', '\\')
+private val markdownV2PreAndCodeEscapes = mutableSetOf('`', '\\')
+private val markdownV2CommonEscapes = mutableSetOf(
+    '_',
+    '*',
+    '[', ']',
+    '(', ')',
+    '~',
+    '`',
+    '>',
+    '#',
+    '+', '-', '=',
+    '|',
+    '{', '}',
+    '.', '!'
+)
+private fun String.escapeMarkdownV2(escapeCharacters: Iterable<Char>): String = map {
+    if (it in escapeCharacters) {
+        "\\$it"
+    } else {
+        "$it"
+    }
+}.joinToString("")
+fun String.escapeMarkdownV2Link() = escapeMarkdownV2(markdownV2LinkEscapes)
+fun String.escapeMarkdownV2PreAndCode() = escapeMarkdownV2(markdownV2PreAndCodeEscapes)
+fun String.escapeMarkdownV2Common() = escapeMarkdownV2(markdownV2CommonEscapes)
+
 fun String.toHtml(): String = replace(
     "<",
     "&lt;"

src/commonTest/kotlin/com/github/insanusmokrassar/TelegramBotAPI/types/MessageEntity/TextPartsCreatingTests.kt

@@ -0,0 +1,142 @@
+package com.github.insanusmokrassar.TelegramBotAPI.types.MessageEntity
+
+import com.github.insanusmokrassar.TelegramBotAPI.types.MessageEntity.textsources.*
+import com.github.insanusmokrassar.TelegramBotAPI.types.ParseMode.MarkdownV2
+import com.github.insanusmokrassar.TelegramBotAPI.utils.*
+import kotlin.test.*
+
+class TextPartsCreatingTests {
+    @Test
+    fun testThatTextWithMultilevelPartsCorrectlyCreating() {
+        val text = "It is simple hello world"
+        val formattedV2Text = "It *_is_ ~__simple__~* hello world"
+        val entities = listOf(
+            RawMessageEntity(
+                "bold",
+                3,
+                9
+            ),
+            RawMessageEntity(
+                "italic",
+                3,
+                2
+            ),
+            RawMessageEntity(
+                "strikethrough",
+                6,
+                6
+            ),
+            RawMessageEntity(
+                "underline",
+                6,
+                6
+            )
+        )
+
+        val textParts = createTextPart(text, entities)
+
+
+        assertTrue (
+            textParts.first().source is BoldTextSource
+        )
+
+        val boldSource = textParts.first().source as BoldTextSource
+        assertTrue (
+            boldSource.textParts.first().source is ItalicTextSource
+        )
+        assertTrue (
+            boldSource.textParts[1].source is RegularTextSource
+        )
+        assertTrue (
+            boldSource.textParts[2].source is StrikethroughTextSource
+        )
+        assertTrue (
+            (boldSource.textParts[2].source as StrikethroughTextSource).textParts.first().source is UnderlineTextSource
+        )
+
+
+        val fullTextParts = text.fullListOfSubSource(textParts)
+
+        assertTrue(
+            fullTextParts.first().source is RegularTextSource
+        )
+        assertTrue(
+            fullTextParts[1].source is BoldTextSource
+        )
+        assertTrue(
+            fullTextParts[2].source is RegularTextSource
+        )
+
+        assertEquals(
+            formattedV2Text,
+            createMarkdownV2Text(fullTextParts.map { it.source }).first()
+        )
+    }
+
+    @Test
+    fun testThatTextWithMultilevelPartsCorrectlyCreatingInHtml() {
+        val text = "It is simple hello world"
+        val formattedHtmlText = "It <b><i>is</i> <s><u>simple</u></s></b> hello world"
+        val entities = listOf(
+            RawMessageEntity(
+                "bold",
+                3,
+                9
+            ),
+            RawMessageEntity(
+                "italic",
+                3,
+                2
+            ),
+            RawMessageEntity(
+                "strikethrough",
+                6,
+                6
+            ),
+            RawMessageEntity(
+                "underline",
+                6,
+                6
+            )
+        )
+
+        val textParts = createTextPart(text, entities)
+
+
+        assertTrue (
+            textParts.first().source is BoldTextSource
+        )
+
+        val boldSource = textParts.first().source as BoldTextSource
+        assertTrue (
+            boldSource.textParts.first().source is ItalicTextSource
+        )
+        assertTrue (
+            boldSource.textParts[1].source is RegularTextSource
+        )
+        assertTrue (
+            boldSource.textParts[2].source is StrikethroughTextSource
+        )
+        assertTrue (
+            (boldSource.textParts[2].source as StrikethroughTextSource).textParts.first().source is UnderlineTextSource
+        )
+
+
+        val fullTextParts = text.fullListOfSubSource(textParts)
+
+        assertTrue(
+            fullTextParts.first().source is RegularTextSource
+        )
+        assertTrue(
+            fullTextParts[1].source is BoldTextSource
+        )
+        assertTrue(
+            fullTextParts[2].source is RegularTextSource
+        )
+
+        assertEquals(
+            formattedHtmlText,
+            createHtmlText(fullTextParts.map { it.source }).first()
+        )
+    }
+}